sntl_lg_decode_current_state() Function

Description

Decodes a current state.

Usage Notes

This function decodes a "current state" file or buffer, and writes the decoded information as an XML buffer. The current state can be a C2V file, the resultant state (returned from the sntl_lg_generate_license() function), or a fingerprint. This function requires the Vendor Code. The Vendor Codes are stored in a VendorCodes directory in your system.

Before you call the sntl_lg_decode_current_state() function, you must call sntl_lg_initialize().

The XML tags that are used in the decoded current state are described here.

Syntax

sntl_lg_status_t SNTL_LG_CALLCONV sntl_lg_decode_current_state ( 
          sntl_lg_handle_t handle,  
          sntl_lg_vendor_code_t vendor_code,  
          const char *current_state,
          char **readable_state           )

Parameters

handle

[IN] License generation handle.

vendor_code

[IN] Pointer to the Vendor Code.

current_state

[IN] The current state. It can be contents of a C2V file or the resultant key state from the sntl_lg_generate_license() function or a fingerprint.

readable_state

[OUT] Pointer to the decoded information.

Return Values

SNTL_LG_STATUS_OK

SNTL_LG_LIB_INITIALIZATION_FAILED

SNTL_LG_RESOURCE_LOCK_FAILURE

SNTL_LG_OUT_OF_MEMORY

SNTL_LG_INVALID_HANDLE

SNTL_LG_INVALID_PARAMETER

SNTL_LG_INVALID_VENDOR_CODE

SNTL_LG_INVALID_KEY_CURRENT_STATE

SNTL_LG_NOT_SUPPORTED_KEY_TYPE

SNTL_LG_MASTER_KEY_CONNECT_ERROR

SNTL_LG_MASTER_KEY_IO_ERROR

SNTL_LG_MASTER_KEY_ACCESS_ERROR

SNTL_LG_INTERNAL_ERROR

Related Topics

sntl_lg_initialize()

XML Tags for Output From the sntl_lg_decode_current_state() Function