VLSverifyRevocationTicket

Syntax

LS_STATUS_CODE VLSverifyRevocationTicket (PVPT_REQUEST pvOriginalRequest,
   					   unsigned char *pucRevocationTicket,
					   unsigned long ulRevocationTicketLength,
					   PVRT_VERIFY_ERRORS pvErrorInfo,
   					   unsigned long *pulErrorInfoTotalLength);

Argument	Description
pvOriginalRequest	A pointer to the structure containing data for the original request.
pucRevocationTicket	A pointer to the returned revocation ticket.
ulRevocationTicketLength	The length of the revocation ticket.
pvErrorInfo	A pointer to the structure to store the error report. The memory needs to be allocated by the caller.
pulErrorInfoTotalLength	The size of the pvErrorInfo argument. If the pvErrorInfo argument is passed as NULL or the length is less than the size required for the error report, the function will return the required length. The caller needs to allocate the required memory and call the API again.

Description

This function verifies the returned API revocation ticket against the original request i.e. the permission ticket.

The API does not allow verification against the PT in binary format. Also, it does not verify the information contained in pucVendorDefined.

Returns

The status code LS_SUCCESS is returned, if revocation ticket is verified successfully. Otherwise, it will return the following error codes:

Error Code	Description
VLScg_RT_PARAMETERS_ERROR	Invalid rehost parameters.
VLScg_RT_ALLOCATE_MEMORY_FAILURE	Failure in memory allocation.
VLScg_RT_VERSION_MISMATCH	Rehost ticket version mismatch.
VLScg_RT_REHOST_LINE_CORRUPT	Rehost ticket line is corrupt.
VLScg_RT_TRANSACTION_ID_MISMATCH	Transaction Id in rehost ticket is different from in request.
VLScg_RT_LOCK_CODE_MISMATCH	Lock code in rehost ticket is different from in request.
VLScg_RT_REQUESTED_ACTION_NOT_PERFORMED	Actions requested are not performed.
VLScg_RT_NON_REQUESTED_ACTION_PERFORMED	Action performed was not requested.
VLScg_RT_ACTION_STATUS_NOT_SUCCESS	Requested action failed.
VLScg_RT_REQUEST_EMPTY	Request is empty.
VLScg_RT_REQUEST_LINE_INVALID	Requested line is invalid.
VLScg_RT_REHOST_TICKET_INVALID_TLV_STRUCT	Rehost ticket is an invalid TLV (Tag-Length-Value) structure.
VLScg_RT_REHOST_TAG_MISSING	Rehost tag is missing in the rehost ticket.
VLScg_RT_VERIFY_SINGLE_ERROR	Only one error in revocation ticket. Verify if the operation type is specified as NULL.
VLScg_RT_VERIFY_MULTIPLE_ERRORS	Multiple errors in revocation ticket.
VLScg_RT_VERSION_TAG_MISSING	Version tag is missing in the rehost ticket.
VLScg_RT_TRANSACTION_ID_TAG_MISSING	Transaction Id tag is missing in the rehost ticket.
VLScg_RT_LOCK_SELECTOR_TAG_MISSING	Lock selector tag is missing in the rehost ticket.
VLScg_RT_LOCK_SELECTOR_MISMATCH	Lock selector is different from in request.
VLScg_RT_LOCK_CODE_TAG_MISSING	Lock code is different from in request.
VLScg_RT_HASH_TAG_MISSING	Hash tag is missing in the rehost ticket.
VLScg_RT_VERIFY_SINGLE_ERROR	Only one error in rehost ticket. Verify if the operation type is specified as NULL.
VLScg_RT_VERIFY_MULTIPLE_ERRORS	Multiple errors in rehost ticket.
VLScg_RT_TIME_STAMP_MISMATCH	Mismatch in time stamp.
VLScg_RT_TIME_STAMP_TAG_MISSING	Mismatch in time stamp tag.