VLSgetContextData

Syntax

LS_STATUS_CODE	       VMSWINAPI VLSgetContextData (
LS_HANDLE	 	lshandle,
unsigned char	 	LSFAR *context_buff,
unsigned long	 	buff_len,
LS_CHALLENGE	 	LSFAR *challenge ); 	 	 

Parameter	Direction	Data Type	Description
lshandle	IN	LS_HANDLE	The license handle. A valid license handle is returned by the License Manager when the license request is successful.
context_buff	OUT	unsigned char	A pointer to a user allocated memory to be filled by the API with the current context data on its return.
buff_len		unsigned long	Contains the length of the allocated buffer.
challenge	UNUSED	LS_CHALLENGE	Currently unused. Use NULL.

Description

Returns the current context data stored in the volume transaction licensing database for a particular license.

Returns

The API returns LS_SUCCESS when the API is successful otherwise it returns the following error codes:

Status	Description
VLS_CALLING_ERROR	>When context_buff is NULL. >When buff_len is less than zero or greater than VLS_MAX_CONTEXT_LEN+1
LS_BADHANDLE	An invalid handle.
VLS_NOT_SUPPORTED	If the API is called with a handle corresponding to a queued client or a capacity token.
VLS_NO_RECORDS_FOUND	No records for the context in the database.