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
| 
                                                                     
  | 
                                                                
                                                                     [IN] License generation handle.  | 
                                                            
| 
                                                                     
  | 
                                                                
                                                                     [IN] Pointer to the Vendor Code.  | 
                                                            
| 
                                                                     
  | 
                                                                
                                                                     [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_LIB_INITIALIZATION_FAILED
SNTL_LG_INVALID_KEY_CURRENT_STATE
SNTL_LG_NOT_SUPPORTED_KEY_TYPE
SNTL_LG_MASTER_KEY_CONNECT_ERROR
SNTL_LG_MASTER_KEY_ACCESS_ERROR
Related Topics
XML Tags for Output From the sntl_lg_decode_current_state() Function
