E:/new_work/branches/ss_v2.0/include_out/d2c.h

浏览该文件的文档.

#ifndef _D2C_H
#define _D2C_H

#include "ss_define.h"


#define MAX_ACCOUNT_NAME_LENGTH         64      

#define D2C_GUID_LENGTH                 37      

#define FIXTIME_RAND_LENGTH             8       

#define SNIPPET_SEED_LENGTH             32      

#define ACCESS_READ                     0x01    

#define ACCESS_WRITE_DELETE             0x02    

#define ACCESS_USE                      0x04    

#define ACCESS_WRITE_DELETE_RU          0x08    

#define ACCESS_ENTRY_READ               0x10    

#define ACCESS_ENTRY_WRITE_DELETE       0x20    

#define ACCESS_ENTRY_USE                0x40    

#define ACCESS_ENTRY_WRITE_DELETE_RU    0x80    

#define PKI_CA_TYPE_SYSTEM                          0       

#define PKI_CA_TYPE_DEVELOPER                       1       

#define PKI_CA_TYPE_DEVICE                          2       

#define PKI_CA_TYPE_ACCOUNT                         3       

#define PKI_CA_TYPE_ROOT                            0x80    

#define CTRL_PIN_MIN_SIZE               8

#define CTRL_PIN_MAX_SIZE               255

typedef struct _D2C_HANDLE_INTERNAL* D2C_HANDLE;

typedef struct _MASTER_HANDLE_INTERNAL* MASTER_HANDLE;

typedef enum _SIGN_TYPE 
{
    SIGN_TYPE_CERT          = 1,    
    SIGN_TYPE_SEED          = 2
    
} SIGN_TYPE;

typedef enum _D2C_HASH_ALGO 
{
    D2C_HASH_ALGO_SHA1 = 1,
    D2C_HASH_ALGO_SHA256 = 2
    
} D2C_HASH_ALGO;

typedef enum _ACCOUNT_TYPE 
{
    ACCOUNT_TYPE_NONE   = 0, 
    ACCOUNT_TYPE_USB    = 1,
    ACCOUNT_TYPE_EMAIL  = 2,
    ACCOUNT_TYPE_PHONE  = 3
    
} ACCOUNT_TYPE;

typedef struct _SNIPPET_CODE_CONTEXT 
{
    SS_UINT32       version;    
    SS_UINT32       code_id;    
    SS_UINT32       license_id; 
    SS_BYTE         key[32];  
    SS_BYTE         snippet_seed[SNIPPET_SEED_LENGTH]; 
} SNIPPET_CODE_CONTEXT;

#ifdef __cplusplus
extern "C" {
#endif

    SS_UINT32 SSAPI master_open(OUT MASTER_HANDLE* device_handle);

    SS_UINT32 SSAPI master_close(IN MASTER_HANDLE device_handle);

    SS_UINT32 SSAPI master_get_developer_id(IN MASTER_HANDLE device_handle, OUT SS_BYTE *developer_id);

    SS_UINT32 SSAPI master_get_root_count(IN MASTER_HANDLE device_handle, OUT SS_UINT32 *count);

    SS_UINT32 SSAPI master_get_ca_cert(IN MASTER_HANDLE device_handle, IN SS_BYTE ca_type,
        OUT SS_BYTE *ca_cert, IN SS_UINT32 cert_bufsize, OUT SS_UINT32 *cert_size);


    SS_UINT32 SSAPI master_get_ca_cert_ex(IN MASTER_HANDLE device_handle, IN SS_BYTE ca_type, IN SS_UINT32 root_index,
        OUT SS_BYTE *ca_cert, IN SS_UINT32 cert_bufsize, OUT SS_UINT32 *cert_size);

    SS_UINT32 SSAPI master_get_root_ca(IN MASTER_HANDLE device_handle,
        OUT SS_BYTE *root_ca, IN SS_UINT32 root_bufsize, OUT SS_UINT32 *root_size);

    SS_UINT32 SSAPI master_get_device_ca(IN MASTER_HANDLE device_handle,
        OUT SS_BYTE *device_ca, IN SS_UINT32 device_bufsize, OUT SS_UINT32 *device_size);

    SS_UINT32 SSAPI master_get_developer_ca(IN MASTER_HANDLE device_handle,
        OUT SS_BYTE *developer_ca, IN SS_UINT32 ca_bufsize, OUT SS_UINT32 *ca_size);

    SS_UINT32 SSAPI master_get_developer_cert(IN MASTER_HANDLE device_handle,
        OUT SS_BYTE *developer_cert, IN SS_UINT32 cert_bufsize, OUT SS_UINT32 *cert_size);

    SS_UINT32 SSAPI master_get_developer_cert_ex(IN MASTER_HANDLE device_handle, IN SS_UINT32 root_index,
        OUT SS_BYTE* developer_cert, IN SS_UINT32 cert_bufsize, OUT SS_UINT32* cert_size);
    SS_UINT32 SSAPI master_verify_ca(IN MASTER_HANDLE device_handle, IN SS_BOOL store, 
        IN SS_BYTE ca_type, IN SS_BYTE *ca_cert, IN SS_UINT32 ca_len);

    SS_UINT32 SSAPI master_verify_ca_ex(IN MASTER_HANDLE device_handle, IN SS_BOOL store,
        IN SS_BYTE ca_type, IN SS_UINT32 root_index, IN SS_BYTE *ca_cert, IN SS_UINT32 ca_len);

    SS_UINT32 SSAPI master_get_seedkey(
        IN  MASTER_HANDLE   device_handle,
        OUT SS_BYTE*        key,
        IN  SS_UINT32       max_key_len,
        OUT SS_UINT32*      key_len
        );

    SS_UINT32 SSAPI master_get_info(IN MASTER_HANDLE device_handle, IN SS_BYTE type, OUT char **info);

    SS_UINT32 SSAPI master_heap_free(IN void *buf);

    SS_UINT32 SSAPI master_pin_change(
        IN MASTER_HANDLE    device_handle,
        IN SS_BYTE          pin_index,
        IN SS_BYTE          *old_pin,
        IN SS_UINT32        old_pin_len,
        IN SS_BYTE          *new_pin,
        IN SS_UINT32        new_pin_len,
        IN SS_BYTE          *hash
        );

    SS_UINT32 SSAPI master_pin_verify(
        IN MASTER_HANDLE    device_handle,
        IN SS_BYTE          pin_index,
        IN SS_BYTE          *pin,
        IN SS_UINT32        pin_len
        );

    SS_UINT32 SSAPI master_pin_is_verified(MASTER_HANDLE device_handle);

    SS_UINT32 SSAPI master_pin_enable(MASTER_HANDLE device_handle);

    SS_UINT32 SSAPI master_pin_disable(MASTER_HANDLE device_handle);

    SS_UINT32 SSAPI master_pin_deauth(MASTER_HANDLE device_handle);


    SS_UINT32 SSAPI d2c_lic_new(
        IN  MASTER_HANDLE   device_handle,
        OUT D2C_HANDLE*     d2c_license,
        IN  ACCOUNT_TYPE    account_type,
        IN  SS_BYTE*        account_id,
        IN  SS_UINT32       account_size,
        IN  SS_BYTE*        cert,
        IN  SS_UINT32       cert_size
        );

    SS_UINT32 SSAPI d2c_file_new(
        IN  MASTER_HANDLE   device_handle,
        OUT D2C_HANDLE*     d2c_file,
        IN  SIGN_TYPE       sign_type,
        IN  SS_BYTE*        param,
        IN  SS_UINT32       param_size
        );

    SS_UINT32 SSAPI d2c_add_developer_cert(D2C_HANDLE d2c_handle, SS_BYTE* cert, SS_UINT32 cert_len);

    SS_UINT32 SSAPI gen_dynamic_code(
        IN  MASTER_HANDLE   device_handle,
        IN  SIGN_TYPE       sign_type,
        IN  SS_BYTE*        param,
        IN  SS_UINT32       param_size,
        IN  SS_BYTE*        exec_code,
        IN  SS_UINT32       code_size,
        IN  SS_UINT32*      bound_info,
        IN  SS_UINT32       bound_size,
        OUT SS_BYTE*        pkg,
        IN  SS_UINT32       max_pkg_len,
        OUT SS_UINT32*      pkg_len
        );

    SS_UINT32 SSAPI d2c_add_pkg(
        IN  D2C_HANDLE          d2c_file,
        IN  SS_CHAR*            param,
        IN  SS_CHAR*            opr_desc
        );

    SS_UINT32 SSAPI d2c_add_lic(
        IN  D2C_HANDLE          d2c_license,
        IN  SS_CHAR*            param,
        IN  SS_CHAR*            opr_desc,
        OUT SS_CHAR             guid[D2C_GUID_LENGTH]
        );
    
    SS_UINT32 SSAPI d2c_get(
        IN  D2C_HANDLE      d2c_handle,
        OUT SS_CHAR*        d2c_buf,
        IN  SS_UINT32       max_buf_len,
        OUT SS_UINT32*      out_len
        );

    const SS_CHAR* d2c_get_pkg_desc(
        IN  D2C_HANDLE      d2c_handle,
        IN  SS_UINT32       index
        );

    SS_UINT32 SSAPI d2c_delete(
        IN  D2C_HANDLE      d2c_handle
        );

    SS_UINT32 SSAPI d2c_sign(IN MASTER_HANDLE master_handle, D2C_HASH_ALGO hash_algo, IN SS_UINT32 root_index, IN SS_BYTE* data_in, IN SS_UINT32 data_len,
        OUT SS_BYTE* sign, IN SS_UINT32 max_sign_len, OUT SS_UINT32* sign_len);

    SS_UINT32 SSAPI d2c_encrypt(IN SS_BYTE* certs, IN SS_UINT32 certs_len, IN const SS_BYTE* plain, IN SS_UINT32 plain_len,
        OUT SS_BYTE* cipher, IN SS_UINT32 max_cipher_len, OUT SS_UINT32* cipher_len);

    SS_UINT32 SSAPI get_snippet_seed(IN MASTER_HANDLE master, IN SS_UINT32 license_id, OUT SS_BYTE snippet_seed[SNIPPET_SEED_LENGTH]);

    SS_UINT32 SSAPI gen_snippet_code(IN MASTER_HANDLE master, IN SS_UINT32 license_id, IN const SS_BYTE* evx_code, IN SS_UINT32 evx_size,
        OUT SS_BYTE* snippet_code, IN SS_UINT32 snippet_buf_size, OUT SS_UINT32* snippet_size);
    
    SS_UINT32 SSAPI gen_snippet_code_with_key(IN const SNIPPET_CODE_CONTEXT* sc_ctx, IN const SS_BYTE* evx, IN SS_UINT32 evx_size,
        OUT SS_BYTE* snippet_code, IN SS_UINT32 snippet_bufsize, OUT SS_UINT32* snippet_size);

    SS_UINT32 SSAPI license_encrypt(IN MASTER_HANDLE master, IN SS_UINT32 license_id, IN const SS_BYTE* plain, IN SS_UINT32 len, OUT SS_BYTE* cipher);

#ifdef __cplusplus
}
#endif

#endif  //  _D2C_H