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

浏览该文件的文档.

#ifndef _H_DEF_SLM_CONTROL_API_
#define _H_DEF_SLM_CONTROL_API_

#include "ss_define.h"

#ifdef  _MSC_VER
#pragma comment(linker, "/defaultlib:setupapi.lib")
#elif defined __WATCOMC__
#pragma library("\watcom\lib386\nt\setupapi.lib")
#endif

#if _MSC_VER >= 1900   // 1900是VS2015的版本号，解决静态库在VS2015下编译失败的问题
#pragma comment(linker, "/defaultlib:legacy_stdio_definitions.lib")
#endif  // MSC_VER

#ifndef __SS_LM_RUMTIME_H__

#define SLM_FIXTIME_RAND_LENGTH     8
#endif

#define SLM_CTRL_LED_COLOR_BLUE      0

#define SLM_CTRL_LED_COLOR_RED       1

#define SLM_CTRL_LED_STATE_CLOSE     0

#define SLM_CTRL_LED_STATE_OPEN      1

#define SLM_CTRL_LED_STATE_SHRINK    2

#define SLM_CTRL_MAX_CLOUD_SERVER_LENGTH    100

#define SLM_CTRL_MAX_ACCESS_TOKEN_LENGTH    64

#define SLM_SLOCK_LICKEY_LENGTH             32

#define SLM_SLOCK_OFFLINE_UNBIND_C2D_BUF_LENGTH    4096

typedef struct _ST_LOCK_LED_CONTROL {
    SS_UINT32   index;
    SS_UINT32   state;
    SS_UINT32   interval;
} ST_LOCK_LED_CONTROL;


typedef enum _ENUM_LICENSE_KEY_STATUS
{
    ENUM_LICENSE_KEY_UNKNOW = 0,
    ENUM_LICENSE_KEY_NORMAL = 1,
    ENUM_LICENSE_KEY_UPDATE = 2,
    ENUM_LICENSE_KEY_DELETE = 3, 
    ENUM_LICENSE_KEY_FORBID = 4,
    ENUM_LICENSE_KEY_INVALID = 5,
}ENUM_LICENSE_KEY_STATUS;

#ifdef __cplusplus
extern "C" {
#endif

SS_UINT32 SSAPI slm_ctrl_client_open(OUT void** ipc);

SS_UINT32 SSAPI slm_ctrl_client_close(IN void* ipc);

SS_UINT32 SSAPI slm_ctrl_get_all_description(
    IN  void*       ipc,
    IN  INFO_FORMAT_TYPE format_type,
    OUT char**      desc
    );


SS_UINT32 SSAPI slm_ctrl_get_cloud_description(
    IN  void*               ipc,
    IN  const SS_CHAR*      access_token,
    IN  const SS_CHAR*      user_guid,
    OUT SS_CHAR**           descriptions
    );

SS_UINT32 SSAPI slm_ctrl_get_local_description(
    IN  void*       ipc,
    IN  INFO_FORMAT_TYPE format_type,
    OUT char**      desc
    );


SS_UINT32 SSAPI slm_ctrl_get_remote_description(
    IN  void*       ipc,
    IN  INFO_FORMAT_TYPE format_type,
    OUT char**      desc
    );


SS_UINT32 SSAPI slm_ctrl_get_license_id(
    IN  void *              ipc,
    IN  INFO_FORMAT_TYPE    type,
    IN  const char*         desc,
    OUT char**              result
    );

SS_UINT32  SSAPI slm_ctrl_read_brief_license_context(
    IN  void                 *ipc,
    IN  INFO_FORMAT_TYPE     type,
    IN  const char           *desc,
    OUT char                 **result
    );

SS_UINT32 SSAPI slm_ctrl_get_pub_size(
    IN  void*           ipc,
    IN  SS_UINT32       license_id,
    IN  const char*     desc,
    OUT SS_UINT32*      len
    );

SS_UINT32 SSAPI slm_ctrl_read_pub_data(
    IN  void*           ipc,
    IN  SS_UINT32       license_id,
    IN  const char*     desc,       //  设备描述
    OUT SS_BYTE*        readbuf,
    IN  SS_UINT32       offset,
    IN  SS_UINT32       len
    );

SS_UINT32 SSAPI slm_ctrl_read_license_context(
    IN  void                *ipc,
    IN  INFO_FORMAT_TYPE    type,
    IN  SS_UINT32           license_id,
    IN  const char          *desc,
    OUT char                **result
    );

SS_UINT32  SSAPI slm_ctrl_read_session_context(
    IN  void*               ipc,
    IN  INFO_FORMAT_TYPE    type,
    IN  const char*         desc,
    OUT char**              result
    );

SS_UINT32 SSAPI slm_ctrl_kick_session(
    IN  void*       ipc,
    IN  const char* desc,
    IN  SS_UINT32   session_id
    );

SS_UINT32 SSAPI slm_ctrl_clear_history(
    IN  void*       ipc,
    IN  const char* desc
    );


SS_UINT32  SSAPI slm_ctrl_get_device_info(
    IN  void*           ipc,
    IN  const char*     desc,
    OUT char**          result
    );

SS_UINT32 SSAPI slm_ctrl_adjust_time_request(
    IN  void*               ipc,
    IN  const char*         desc,
    OUT SS_BYTE             rand[SLM_FIXTIME_RAND_LENGTH],
    OUT SS_UINT32*          lock_time,
    IN OUT SS_UINT32*       pc_time
    );
SS_UINT32  SSAPI slm_ctrl_get_filelist_info(
    IN  void*            ipc,
    IN  const char*      desc,
    OUT char**           result
    );

SS_UINT32 SSAPI slm_ctrl_get_cert(
    IN  void*               ipc,
    IN  const char*         desc,
    IN  CERT_TYPE           cert_type,
    OUT SS_BYTE*            cert,
    IN  SS_UINT32           cert_size,
    OUT SS_UINT32*          cert_len
    );

SS_UINT32 SSAPI slm_ctrl_get_device_cert(
    IN  void*               ipc,
    IN  const char*         desc,
    OUT SS_BYTE*            device_cert,
    IN  SS_UINT32           buff_size,
    OUT SS_UINT32*          return_size
    );


SS_UINT32 SSAPI slm_ctrl_get_sense_device_cert(
    IN  void*               ipc,
    IN  const char*         desc,
    OUT SS_BYTE*            device_cert,
    IN  SS_UINT32           buff_size,
    OUT SS_UINT32*          return_size
    );


SS_UINT32 SSAPI slm_ctrl_sign_by_device(
    IN  void*               ipc,
    IN  const char*         desc,
    IN  SS_BYTE*            verify_data,
    IN  SS_UINT32           verify_data_size,
    OUT SS_BYTE*            signature,
    IN  SS_UINT32           signature_buf_size,
    OUT SS_UINT32*          signature_size
    );

SS_UINT32 SSAPI slm_ctrl_led_control(
    IN  void*               ipc,
    IN  const char*         desc,
    IN  ST_LOCK_LED_CONTROL*     led_ctrl
    );

void SSAPI slm_ctrl_free(
    IN  void*   buffer
    );

SS_UINT32 SSAPI slm_ctrl_query_bind_info(
    IN  void*           ipc,          
    IN  const char*     desc, 
    IN  SS_UINT32       license_id,
    OUT char**          result
    );

SS_UINT32 SSAPI slm_ctrl_bind_offline_license(
    IN void*        ipc, 
    IN const char*  desc, 
    IN SS_UINT32    license_id
    );

SS_UINT32 SSAPI slm_ctrl_get_offline_desc(IN void* ipc, OUT char** desc);

SS_UINT32 SSAPI slm_ctrl_get_offline_local_desc(IN void* ipc, OUT char** desc);

SS_UINT32 SSAPI slm_ctrl_get_offline_remote_desc(IN void* ipc, OUT char** desc);

SS_UINT32 SSAPI slm_ctrl_unbind_offline_license(IN void* ipc, IN const char* desc, IN SS_UINT32 license_id);

// -------------------
SS_UINT32 SSAPI slm_ctrl_offline_bind_c2d(
    IN void         *ipc, 
    OUT SS_BYTE     *bind_c2d,
    IN SS_UINT32    c2d_buf_size,
    OUT SS_UINT32   *c2d_length);

SS_UINT32 SSAPI slm_ctrl_offline_unbind_c2d(
    IN void         *ipc, 
    IN const char   *desc, 
    IN SS_UINT32    license_id,    
    OUT SS_BYTE     *unbind_c2d,
    IN SS_UINT32    c2d_buf_size,
    OUT SS_UINT32   *c2d_length
    );

SS_UINT32 SSAPI slm_ctrl_offline_bind_d2c(
    IN void         *ipc, 
    IN char         *d2c
    );

SS_UINT32 SSAPI slm_ctrl_cloud_offline_get_d2c(
    IN  void            *ipc, 
    IN  const char      *desc,
    IN  SS_UINT32       license_id,
    IN  SS_BYTE         *bind_c2d, 
    IN  SS_UINT32       c2d_length,
    OUT char            **result
    );

SS_UINT32 SSAPI slm_ctrl_cloud_offline_unbind(
    IN  void            *ipc,
    IN  const char      *user_guid,
    IN  SS_BYTE         *unbind_c2d,
    IN  SS_UINT32       c2d_length
    );

SS_UINT32 SSAPI slm_ctrl_bind_license_key(
    IN void             * ipc, 
    IN const char       *license_key
    );

SS_UINT32 SSAPI slm_ctrl_slock_refresh_license(
    IN  void            *ipc,
    IN  char            *desc,
    IN  SS_UINT32       license_id,
    IN  char            *license_key
    );
    
SS_UINT32 SSAPI slm_ctrl_update(
    char* d2c_pkg, 
    char** error_msg);

SS_UINT32 SSAPI slm_ctrl_update_ex(
    SS_BYTE* lock_sn, 
    char* d2c_pkg, 
    char** error_msg);

// ----------------------------------------

SS_UINT32 SSAPI slm_ctrl_init_cloud_server_config(IN const char *cloud_server_config);

#ifdef __cplusplus
};
#endif //__cplusplus

#endif //_H_DEF_SLM_CONTROL_API_