VLSsetContextData

Syntax

LS_STATUS_CODE VMSWINAPI VLSsetContextData (	 	 
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	IN	unsigned char	Contains a pointer to a user allocated memory having the context data to be written in the consume database.
buff_len	IN	unsigned long	Contains the length of the allocated buffer.
challenge	UNUSED	LS_CHALLENGE	Currently unused. Use NULL.

Description

Sets the current context data with the data passed in context_buff 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_OPERATION_NOT_SUCCESSFUL	The requested operation failed for any other reasons.