VLSgeneratePermissionTicket
Syntax
LS_STATUS_CODE VLSgeneratePermissionTicket (PVPT_REQUEST pvRequest,
unsigned char *pucPermissionTicket,
unsigned int *pui16PermissionTicketLength);
|
Argument |
Description |
| pvRequest |
A pointer to the structure containing request data. |
| pucPermissionTicket |
A pointer to the generated permission ticket. Memory needs to be allocated by the caller. |
| pui16PermissionTicketLength |
The length of the generated permission ticket. For version 19 licenses, the maximum permission ticket size (array size = 10) can be 60249 bytes. |
Description
This function is used to generate a permission ticket for revoking (and thereafter adding) the standalone licenses.
If the pucPermissionTicket argument is passed as NULL or its length is less than the length of the generated permission ticket, the function will return the required length. Allocate the required memory and call the API function again.
Returns
The status code LS_SUCCESS is returned, if permission ticket is generated successfully. Otherwise, it will return the following error codes:
| Error Codes | Description |
|
VLScg_RT_INVALID_REQUEST_DATA |
The requested data is invalid. |
|
VLScg_RT_BUFFER_TOO_SMALL |
The allocated memory is not enough. |
|
VLScg_RT_PARAMETERS_ERROR |
Invalid rehost parameters. |
| VLScg_TOO_MANY_OPERATIONS_FOR_SINGLE_PT |
The number of operations specified in the permission ticket exceeds the maximum limit. This error can occur in one of the following scenarios:
|
|
VLScg_RT_ALLOCATE_MEMORY_FAILURE |
Failure in memory allocation. |