/* * * CBitAnswer 类的定义，开发人员可以直接调用操作授权 * * BitAnswer Ltd. (C) 2009 - ?. All rights reserved. * */ #pragma once #include using namespace std; #if !defined(WITH_AKSTYPES) && !defined(WITH_OEFTYPES) #if defined(_MSC_VER) || defined(__WATCOMC__) || defined(__BORLANDC__) typedef unsigned __int64 BIT_UINT64; typedef signed __int64 BIT_INT64; #else typedef unsigned long long BIT_UINT64; typedef signed long long BIT_INT64; #endif #if defined(_MSC_VER) typedef unsigned long BIT_UINT32; typedef signed long BIT_INT32; #else typedef unsigned int BIT_UINT32; typedef signed int BIT_INT32; #endif typedef unsigned short BIT_USHORT; typedef signed short BIT_SHORT; typedef unsigned char BIT_UCHAR; typedef char BIT_CHAR; typedef const char *BIT_PCSTR; #endif typedef void *BIT_HANDLE; typedef void BIT_VOID; typedef enum BIT_ERROR_CODES BIT_STATUS; #if defined(_WIN32) || defined(WIN32) || defined(_MSC_VER) || defined(__BORLANDC__) #define BIT_CALLCONV __stdcall #else #define BIT_CALLCONV #endif #if _MSC_VER >= 1900 #pragma comment(lib, "legacy_stdio_definitions.lib") #endif #ifdef _WIN64 #ifdef _MT #ifdef _DLL #pragma comment(lib, "00003564_000029CA_md_x64.lib") #else #pragma comment(lib, "00003564_000029CA_mt_x64.lib") #endif #else #pragma comment(lib, "00003564_000029CA_mt_x64.lib") #endif #elif defined(_WIN32) || defined(WIN32) #ifdef _MT #ifdef _DLL #pragma comment(lib, "00003564_000029CA_md.lib") #else #pragma comment(lib, "00003564_000029CA_mt.lib") #endif #else #pragma comment(lib, "00003564_000029CA_mt.lib") #endif #endif #ifdef __cplusplus extern "C" { #endif /** BITANSWER 下面部分不要修改 */ /** The Application Data is confidential information, please keep it carefully! */ static BIT_UCHAR m_application_data[] = { 0x40,0x80,0xbc,0x0c,0x96,0xd3,0x29,0x2f,0xa8,0x06,0xcd,0x14,0xe7,0x6d,0xba,0xe8, 0xec,0x0d,0x92,0xc1,0x33,0xc3,0x95,0x34,0xfa,0x12,0xc1,0x76,0x79,0x39,0x4d,0xa6, 0x7d,0xe2,0x7e,0xdf,0x3b,0xc4,0x84,0x25,0xf2,0x8e,0x9a,0x9a,0x7f,0x35,0x39,0x81, 0x56,0xd4,0xd5,0x75,0xc9,0xd9,0x47,0x46,0x7d,0xb0,0x57,0xb5,0x72,0xe3,0x88,0x1e, 0x47,0x6e,0x8b,0xd2,0x56,0x0a,0x92,0xa7,0xd9,0x20,0x7e,0x4a,0x80,0x96,0x40,0x88, 0x8a,0xbf,0x1f,0x77,0x72,0x44,0x14,0xc0,0xe9,0x05,0x79,0x29,0x87,0x03,0x63,0x40, 0xe4,0xe7,0x67,0x1b,0x56,0x76,0x24,0x48,0x92,0x0c,0x3c,0xe5,0xa2,0x65,0x4f,0x71, 0x26,0x04,0x48,0xe2,0x5e,0x32,0xd7,0xea,0x27,0x68,0xeb,0xac,0x51,0x19,0xa0,0x8a, 0x95,0x99,0x20,0x98,0xf6,0x5a,0x7a,0x2b,0xf7,0x07,0x95,0x6d,0xdd,0x3d,0x40,0x81, 0xb5,0xfd,0x6a,0x45,0xcb,0x66,0x80,0xac,0xb9,0xac,0xf8,0x86,0xf0,0x60,0xa1,0x4c, 0xdf,0x0f,0x5a,0x33,0x72,0x28,0x7a,0xc2,0x35,0xb7,0x94,0x18,0x28,0x5c,0xed,0x88, 0x26,0x58,0x65,0x64,0xfa,0xfa,0xda,0x32,0x02,0x28,0x58,0x22,0x44,0xd2,0xcd }; typedef enum _FEATURE_TYPE { BIT_FEATURE_CONVERT = 0x03, BIT_FEATURE_READ_ONLY = 0x04, BIT_FEATURE_READ_WRITE = 0x05, BIT_FEATURE_CRYPTION = 0x09, BIT_FEATURE_USER = 0x0a, BIT_FEATURE_UNIFIED = 0x0b, BIT_FEATURE_NONE = 0xFFFFFFFF, } FEATURE_TYPE; typedef enum _LOGIN_MODE { BIT_MODE_LOCAL = 0x01, BIT_MODE_REMOTE = 0x02, BIT_MODE_AUTO = 0x03, BIT_MODE_AUTO_CACHE = 0x07 } LOGIN_MODE; #define LOGIN_MODE_CACHE 4 #define LOGIN_MODE_USB 8 #define LOGIN_MODE_PROCESS 0x10 typedef enum _BINDING_TYPE { BINDING_EXISTING = 0, BINDING_LOCAL = 1, BINDING_USB_STORAGE = 2 } BINDING_TYPE; typedef enum _BIT_INFO_TYPE { BIT_INFO_SERVER_ADDRESS = 0, BIT_INFO_SN = 1, BIT_INFO_SN_FEATURE = 2, BIT_INFO_SN_LICENSE = 3, BIT_INFO_UPDATE_ERROR = 4, BIT_INFO_CONFIG = 5, BIT_INFO_TOKEN_LIST = 7 } BIT_INFO_TYPE; #pragma pack(1) typedef struct _BIT_DATE_TIME { BIT_USHORT year; BIT_UCHAR month; BIT_UCHAR dayOfMonth; BIT_UCHAR hour; BIT_UCHAR minute; BIT_UCHAR second; BIT_UCHAR unused; } BIT_DATE_TIME, *PBIT_DATE_TIME; typedef struct _BIT_FEATURE_INFO { BIT_UINT32 featureId; FEATURE_TYPE type; BIT_CHAR featureName[128]; BIT_DATE_TIME endDateTime; BIT_UINT32 expirationDays; BIT_UINT32 users; } BIT_FEATURE_INFO, *PBIT_FEATURE_INFO; #pragma pack() /** * @defgroup Run-time API Status Codes * * @{ */ typedef enum BIT_ERROR_CODES { BIT_SUCCESS = 0x0000, /** client side error */ BIT_ERR_NETWORK = 0x0101, BIT_ERR_WRONG_HANDLE = 0x0102, BIT_ERR_INVALID_PARAMETER = 0x0103, BIT_ERR_BUFFER_SMALL = 0x0104, BIT_ERR_APPLICATION_DATA = 0x0105, BIT_ERR_HEARTBEAT_THREAD = 0x0106, BIT_ERR_SERVER_BUSY = 0x0107, BIT_ERR_SERVER_DOWN = 0x0108, BIT_ERR_RETURN_NULL = 0x0109, BIT_ERR_CMD_TYPE = 0x010A, BIT_ERR_BADSTRING = 0x010B, BIT_ERR_HANDLE_NULL = 0x010C, BIT_ERR_INVALID_OFF_LINE_SN = 0x010E, BIT_ERR_OFF_LINE_SN_DENIED = 0x010F, BIT_ERR_SN_FILE_NOT_FOUND = 0x0110, BIT_ERR_OFF_LINE_SN_SIGNATURE = 0x0111, BIT_ERR_RUN_TIME_ERROR = 0x0112, BIT_ERR_CHECK_THREAD = 0x0113, BIT_ERR_LICENSE_NOT_FOUND = 0x0114, BIT_ERR_UNEXPECTED = 0x0115, BIT_ERR_DOWNLOAD_UNCOMPLETE = 0x0116, BIT_ERR_POINTS_OVER = 0x0117, BIT_ERR_TLV_BUF_OVER = 0x0118, BIT_ERR_MORE_USB_DISK = 0x0119, BIT_ERR_NO_USB_DISK = 0x011A, BIT_ERR_GET_MID = 0x011B, BIT_ERR_SN_INVALID = 0x011C, BIT_ERR_TIME_TAMPER = 0x011D, BIT_ERR_NOT_ENCRYPTED = 0x011E, BIT_ERR_KEY_NOT_MATCH = 0x011F, BIT_ERR_BINDINGPOLICY_NOT_MATCHED = 0x0120, BIT_ERR_LOAD_EXTENSION_FAILED = 0x0121, BIT_ERR_MALLOC_FAILED = 0x0122, BIT_ERR_REVOKED = 0x0123, BIT_ERR_EXTENSION_EXIST = 0x0124, BIT_ERR_INIT_DBPATH = 0x0125, BIT_ERR_LOCAL_HOST_NULL = 0x0126, BIT_ERR_WRONG_SERVER_TYPE = 0x0127, BIT_ERR_SOAP = 0x0128, BIT_ERR_UDP = 0x0129, BIT_ERR_UPDATE_CODE = 0x012A, BIT_ERR_UPDATE_INFO_VERSION = 0x012B, BIT_ERR_TYPE_NOT_MATCHED = 0x012C, BIT_ERR_INVALID_URL = 0x012D, BIT_ERR_UPDATE_INFO_FORMAT = 0x012E, BIT_ERR_SN_EMPTY = 0x012F, BIT_ERR_SN_ENTRY_NOT_FOUND = 0x0131, BIT_ERR_FUNCTION_NOT_SUPPORT = 0x0132, BIT_ERR_ACCESS_ERROR = 0x0151, BIT_ERR_ACCESS_DENIED = 0x0152, BIT_ERR_ACCESS_NOT_FOUND = 0x0153, BIT_ERR_TOKEN_NOT_SUPPORT = 0x0181, BIT_ERR_TOKEN_NOT_FOUND = 0x0182, BIT_ERR_TOKEN_ACCESS_FAILED = 0x0183, BIT_ERR_TOKEN_READ_FAILED = 0x0184, BIT_ERR_TOKEN_WRITE_FAILED = 0x0185, BIT_ERR_TOKEN_NOT_INIT = 0x0186, BIT_ERR_TOKEN_ALREADY_INIT = 0x0187, /** server side error */ BIT_ERR_NEED_LOGIN = 0x0201, BIT_ERR_NULL_PARAMETER = 0x0202, BIT_ERR_SRV_INVALID_PARAMETER = 0x0203, BIT_ERR_UNKNOWN_EXCEPTION = 0x0204, BIT_ERR_UNKNOWN_VAR = 0x0205, BIT_ERR_PRODUCT_DISABLED = 0x0206, BIT_ERR_DEVELOPER_DISABLED = 0x0207, BIT_ERR_WEB_SERVICE_STOP = 0x0208, BIT_ERR_PRODUCT_NOT_MATCH = 0x020A, BIT_ERR_SERVER_KICKOUT = 0x0212, BIT_ERR_SERVER_DENY = 0x0213, BIT_ERR_OVER_USERS_IN_IP = 0x0214, BIT_ERR_STRING_LENGH = 0x0301, BIT_ERR_BADCOMMAND = 0x0302, BIT_ERR_CMD_LENGTH = 0x0303, BIT_ERR_FEATURE_ADDR = 0x0501, BIT_ERR_FEATURE_ZERO = 0x0502, BIT_ERR_FEATURE_NOT_FOUND = 0x0503, BIT_ERR_FEATURE_TYPE_NOT_MATCH = 0x0504, BIT_ERR_FEATURE_TYPE_PARAM = 0x0505, BIT_ERR_FEATURE_EXPIRATION = 0x0509, BIT_ERR_DATA_NOT_FOUND = 0x0601, BIT_ERR_DATA_INDEX_OVER_LENGTH = 0x0602, BIT_ERR_DATA_OVER_MAX_SIZE = 0x0603, BIT_ERR_DATA_OVER_MAX_COUNT = 0x0604, BIT_ERR_SN_LICENSE_EXPIRATION = 0x0701, BIT_ERR_SN_USER_NUMBER_OVER = 0x0702, BIT_ERR_SN_VOLUME_NUMBER_OVER = 0x0703, BIT_ERR_SN_EXECUTION_COUNTER_OVER = 0x0704, BIT_ERR_SN_DISABLED = 0x0705, BIT_ERR_SN_NOT_FOUND = 0x0706, BIT_ERR_SN_OVER_MAX_SESSION_COUNT = 0x0707, BIT_ERR_SN_EXECUTE_MORE_COMMAND = 0x0708, BIT_ERR_SN_DISABLED_FOR_ATTACK = 0x0709, BIT_ERR_MISSING_USB = 0x070D, BIT_ERR_SN_INVALID_FORMAT = 0x070E, BIT_ERR_CAPACITY_EXHAUSTED = 0x0712, BIT_ERR_CAPACITY_NOT_USED = 0x0713, BIT_ERR_SN_TYPE_NOT_MATCH = 0x0714, BIT_ERR_SN_OFFLINE_EXPIRED = 0x0780, BIT_ERR_SN_MID_CHECK = 0x0781, BIT_ERR_MACHINE_DISABLED = 0x0782, BIT_ERR_NO_AVAILABLE_SN = 0x0783, BIT_ERR_NO_AVAILABLE_MODULE = 0x0784, BIT_ERR_DEMO_UPDATE = 0x0785, BIT_ERR_VM_DISABLED = 0x0786, BIT_ERR_SN_INVALID_STATUS = 0x0787, BIT_ERR_OFF_LINE_ERR = 0x0801, BIT_ERR_OFF_LINE = 0x0802, BIT_ERR_DOWNLOAD_OVER = 0x0803, BIT_ERR_SIGNATURE = 0x0804, BIT_ERR_OFF_LINE_UPDATE_AGAIN = 0x0806, BIT_ERR_WRONG_LOCAL_TIME = 0x0807, BIT_ERR_NO_AVAILABLE_UPDATE = 0x0808, BIT_ERR_LOCAL_SERVICE_UPDATE = 0x0809, BIT_ERR_PRODUCT_NOT_FOUND = 0x0901, BIT_ERR_DEVELOPER_NOT_FOUND = 0x0902, BIT_ERR_INVALID_MID_FROMAT = 0x0903, BIT_ERR_COMMAND_NOT_SUPPORT = 0x0904, BIT_ERR_VERSION_NOT_SUPPORT = 0x0905, BIT_ERR_BINDING_INFO = 0x0906, BIT_ERR_CMD_DATA_LENGTH = 0x0907, BIT_ERR_TABLE_SIGN = 0x090A, BIT_ERR_NOT_INIT = 0x090B, /** for bit service */ BIT_ERR_BIT_SERVICER_SIGN = 0x0A01, BIT_ERR_CONFIG_FILE = 0x0A03, BIT_ERR_INVALID_USER = 0x0A04, BIT_ERR_OLD_PASSWORD_WRONG = 0x0A06, BIT_ERR_PASSWORD_NOT_MATCHED = 0x0A07, BIT_ERR_UPLOAD_FAILURE = 0x0A09, BIT_ERR_LOAD_EXTENTION = 0x0A11, BIT_ERR_PAGE_NOT_FOUND = 0x0A12, BIT_ERR_SN_EXISTED = 0x0A13, BIT_ERR_OLD_EXTENTION = 0x0A14, BIT_ERR_SRV_ROLE_INVALID = 0x0A15, BIT_ERR_SRV_ROLE_EXIST = 0x0A16 }BIT_STATUS; #define BIT_DATA_ITEM_NAME_MAX_LEN 128 #define BIT_DATA_ITEM_MAX_LEN 1024 #define BIT_CIPH_DATA_MAX_LEN 256 /** * @defgroup SESSION_TYPE of session information in XML or plain format * * @{ */ typedef enum _SESSION_TYPE { XML_TYPE_SN_INFO = 3, XML_TYPE_FEATURE_INFO = 4, BIT_SERVER_ADDRESS = 0x101, BIT_SERVER_TIME = 0x201, BIT_CONTROL_TYPE = 0x302, BIT_VOLUME_NUMBER = 0x303, BIT_START_DATE = 0x304, BIT_END_DATE = 0x305, BIT_EXPIRATION_DAYS = 0x306, BIT_USAGE_NUMBER = 0x307, BIT_CONSUMED_USAGE_NUMBER = 0x308, BIT_ACTIVATE_DATE = 0x30A, BIT_USER_LIMIT = 0x30B, BIT_LAST_UPDATE_DATE = 0x30C, BIT_MAX_OFFLINE_MINUTES = 0x30D, BIT_NEXT_CONNECT_DATE = 0x30E, BIT_MID_BINARY = 0x1001 } SESSION_TYPE; /** * @} */ /** * @defgroup The Basic Run-time API * * @{ */ BIT_STATUS BIT_CALLCONV Bit_Login( BIT_PCSTR szURL, BIT_PCSTR szSN, BIT_UCHAR *pApplicationData, BIT_HANDLE *pHandle, LOGIN_MODE mode); BIT_STATUS BIT_CALLCONV Bit_LoginEx( BIT_PCSTR szURL, BIT_PCSTR szSN, BIT_UINT32 featureId, BIT_PCSTR szReserved, BIT_UCHAR *pApplicationData, BIT_HANDLE *pHandle, LOGIN_MODE mode); BIT_STATUS BIT_CALLCONV Bit_Logout( BIT_HANDLE handle); BIT_STATUS BIT_CALLCONV Bit_ReadFeature( BIT_HANDLE handle, BIT_UINT32 featureId, BIT_UINT32 *pFeatureValue); BIT_STATUS BIT_CALLCONV Bit_WriteFeature( BIT_HANDLE handle, BIT_UINT32 featureId, BIT_UINT32 featureValue); BIT_STATUS BIT_CALLCONV Bit_ConvertFeature( BIT_HANDLE handle, BIT_UINT32 featureId, BIT_UINT32 para1, BIT_UINT32 para2, BIT_UINT32 para3, BIT_UINT32 para4, BIT_UINT32 *pResult); BIT_STATUS BIT_CALLCONV Bit_EncryptFeature( BIT_HANDLE handle, BIT_UINT32 featureId, BIT_VOID *pPlainBuffer, BIT_VOID *pCipherBuffer, BIT_UINT32 dataBufferSize); BIT_STATUS BIT_CALLCONV Bit_DecryptFeature( BIT_HANDLE handle, BIT_UINT32 featureId, BIT_VOID *pCipherBuffer, BIT_VOID *pPlainBuffer, BIT_UINT32 dataBufferSize); BIT_STATUS BIT_CALLCONV Bit_QueryFeature( BIT_HANDLE handle, BIT_UINT32 featureId, BIT_UINT32 *pCapacity); BIT_STATUS BIT_CALLCONV Bit_ReleaseFeature( BIT_HANDLE handle, BIT_UINT32 featureId, BIT_UINT32 *pCapacity); BIT_STATUS BIT_CALLCONV Bit_SetDataItem( BIT_HANDLE handle, BIT_PCSTR szDataItemName, BIT_VOID *pDataItemValue, BIT_UINT32 dataItemValueSize); BIT_STATUS BIT_CALLCONV Bit_RemoveDataItem( BIT_HANDLE handle, BIT_PCSTR szDataItemName); BIT_STATUS BIT_CALLCONV Bit_GetDataItem( BIT_HANDLE handle, BIT_PCSTR szDataItemName, BIT_VOID *pDataItemValue, BIT_UINT32 *pDataItemValueSize); BIT_STATUS BIT_CALLCONV Bit_GetDataItemNum( BIT_HANDLE handle, BIT_UINT32 *pNum); BIT_STATUS BIT_CALLCONV Bit_GetDataItemName( BIT_HANDLE handle, BIT_UINT32 index, BIT_CHAR *pDataItemName, BIT_UINT32 *pDataItemNameSize); BIT_STATUS BIT_CALLCONV Bit_GetFeatureInfo( BIT_HANDLE handle, BIT_UINT32 featureId, BIT_FEATURE_INFO *pFeatureInfo); BIT_STATUS BIT_CALLCONV Bit_GetSessionInfo( BIT_HANDLE handle, SESSION_TYPE type, BIT_CHAR *pSessionInfo, BIT_UINT32 *pSessionInfoSize); BIT_STATUS BIT_CALLCONV Bit_GetRequestInfo( BIT_PCSTR szSN, BIT_UCHAR *pApplicationData, BINDING_TYPE type, BIT_CHAR *pRequestInfo, BIT_UINT32 *pRrequestInfoSize); BIT_STATUS BIT_CALLCONV Bit_Revoke( BIT_PCSTR szURL, BIT_PCSTR szSN, BIT_UCHAR *pApplicationData, BIT_CHAR *pRevocationInfo, BIT_UINT32 *pRevocationInfoSize); BIT_STATUS BIT_CALLCONV Bit_GetUpdateInfo( BIT_PCSTR szURL, BIT_PCSTR szSN, BIT_UCHAR *pApplicationData, BIT_PCSTR pRequestInfo, BIT_CHAR *pUpdateInfo, BIT_UINT32 *pUpdateInfoSize); BIT_STATUS BIT_CALLCONV Bit_ApplyUpdateInfo( BIT_UCHAR *pApplicationData, BIT_PCSTR pUpdateInfo, BIT_CHAR *pReceiptInfo, BIT_UINT32 *pReceiptInfoSize); BIT_STATUS BIT_CALLCONV Bit_UpdateOnline( BIT_PCSTR szURL, BIT_PCSTR szSN, BIT_UCHAR *pApplicationData); BIT_STATUS BIT_CALLCONV Bit_SetRootPath( BIT_PCSTR szPath); BIT_STATUS BIT_CALLCONV Bit_GetProductPath( BIT_UCHAR *pApplicationData, BIT_CHAR *buf, BIT_UINT32 lenBuf); BIT_STATUS BIT_CALLCONV Bit_SetLocalServer( BIT_UCHAR *pApplicationData, BIT_PCSTR szHostName, BIT_UINT32 nPort, BIT_UINT32 nTimeoutSeconds); BIT_STATUS BIT_CALLCONV Bit_SetProxy( BIT_UCHAR *pApplicationData, BIT_PCSTR szHostName, BIT_UINT32 nPort, BIT_PCSTR szUserID, BIT_PCSTR szPassword); BIT_STATUS BIT_CALLCONV Bit_GetInfo( BIT_PCSTR szSN, BIT_UCHAR *pApplicationData, BIT_INFO_TYPE type, BIT_CHAR *pInfo, BIT_UINT32 *pInfoSize); BIT_STATUS BIT_CALLCONV Bit_GetVersion( BIT_UINT32 *pVersion); BIT_STATUS BIT_CALLCONV Bit_RemoveSn( BIT_PCSTR szSN, BIT_UCHAR *pApplicationData); BIT_STATUS BIT_CALLCONV Bit_CheckOutSn( BIT_PCSTR szURL, BIT_UINT32 featureId, BIT_UCHAR *pApplicationData, BIT_UINT32 nDurationDays); BIT_STATUS BIT_CALLCONV Bit_CheckOutFeatures( BIT_PCSTR szURL, BIT_UCHAR *pApplicationData, BIT_UINT32 *pFeatureList, BIT_UINT32 nFeatureInList, BIT_UINT32 nDurationDays); BIT_STATUS BIT_CALLCONV Bit_CheckIn( BIT_PCSTR szURL, BIT_UINT32 featureId, BIT_UCHAR *pApplicationData); BIT_STATUS BIT_CALLCONV Bit_TestBitService( BIT_PCSTR szURL, BIT_PCSTR szSN, BIT_UINT32 featureId, BIT_UCHAR *pApplicationData); // 以上部分不要修改 #ifdef __cplusplus } // extern "C" #endif class CBitAnswer { private: BIT_HANDLE m_handle; BIT_UINT32 m_ref; BIT_PCSTR m_sn; LOGIN_MODE m_mode; public: CBitAnswer(void); ~CBitAnswer(void); /** * 进行授权登陆，获取操作句柄。必须在除升级函数之外的其它操作前执行。根据登录模式的不同可能需要连接授权服务器。 * 成功调用一次Login后，对应要调用一次Logout * 如果多次调用Login，没有调用Logout，除了第一次Login之外，其他的Login不会真正的连接授权文件或服务器 * 对于同一台机器，当登陆到云授权时，最大允许10个进程处于Login状态 * 参数： * szSN - [IN] 授权码（SN），由比特平台产生。无论是单机授权还是集团授权，当SN不为NULL时，都表示只登陆这个授权码 * 当SN为空时，根据配置文件会按照以下顺序查找： * 先查本地单机授权码， * 然后查找云授权码（如果本机记住云授权码） * 最后查找集团授权码，如果集团服务中存在多个授权码，均可用，服务会根据使用情况自动分配用户数 * mode - [IN] 登陆模式。 包含以下类型： * BIT_MODE_LOCAL // 登陆本地授权，即单机离线授权码、浮动授权码和演示授权码 * BIT_MODE_REMOTE // 登陆授权，如果授权码失效，会自动连接服务器，并返回连接服务器的错误码 * BIT_MODE_AUTO // 登陆服务器，并自动升级授权 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS Login(BIT_PCSTR szSN, LOGIN_MODE mode); /** * 指定特征项进行授权登录，不连接授权服务器 * * 参数： * szSN - [IN] 同Login * featureId - [IN] 特征项ID * mode - [IN] 同Login */ BIT_STATUS LoginEx(BIT_PCSTR szSN, BIT_UINT32 featureId, LOGIN_MODE mode); /** * 此函数用于释放上下文句柄，退出登录状态。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS Logout(); /** * 此函数用于读取特征项的数据内容，可用于“只读”和“读写”特征类型。 * 参数： * featureId - [IN] 产品的特征项ID。 * pFeatureValue - [OUT] 特征项数据缓存区地址，用于存储读出的数据。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS ReadFeature(BIT_UINT32 featureId, BIT_UINT32 *pFeatureValue); /** * 此函数用于更新“读写”类型的特征项的数据内容。 * 参数： * featureId - [IN] 产品的特征项ID。 * featureValue - [IN] 特征项数据值。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS WriteFeature(BIT_UINT32 featureId, BIT_UINT32 featureValue); /** * 此函数用于使用“算法”类型的特征项对输入参数进行变换操作，得到唯一对应的4字节结果。 * 参数： * featureId - [IN] 产品的特征项ID。 * para1 - [IN] 变换输入因子1 * para2 - [IN] 变换输入因子2 * para3 - [IN] 变换输入因子3 * para4 - [IN] 变换输入因子4 * pResult - [OUT] 变换结果。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS ConvertFeature(BIT_UINT32 featureId, BIT_UINT32 para1, BIT_UINT32 para2, BIT_UINT32 para3, BIT_UINT32 para4, BIT_UINT32 * pResult); /** * 此函数用于使用“密钥”类型的特征项对输入的明文进行加密，返回密文结果。 * 参数： * featureId - [IN] 产品的特征项ID。 * pPlainBuffer - [IN] 数据缓存区地址，用于存储明文数据。 * pCipherBuffer - [OUT] 数据缓存区地址，用于存储密文数据。 * bufferSize - [IN] 数据长度，最大长度为256字节。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS EncryptFeature(BIT_UINT32 featureId, BIT_UCHAR * pPlainBuffer, BIT_UCHAR * pCipherBuffer, BIT_UINT32 bufferSize); /** * 此函数用于使用“密钥”类型的特征项对输入的密文进行解密，返回明文结果。 * 参数： * featureId - [IN] 产品的特征项ID。 * pCipherBuffer - [IN] 数据缓存区地址，用于存储密文数据。 * pPlainBuffer - [OUT] 数据缓存区地址，用于存储明文数据。 * bufferSize - [IN] 数据长度，最大长度为256字节。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS DecryptFeature(BIT_UINT32 featureId, BIT_UCHAR * pCipherBuffer, BIT_UCHAR * pPlainBuffer, BIT_UINT32 bufferSize); /** * 获取“用户”类型特征项的用户数，并返回剩余容量。如没有可分配用户数，则返回1810错误。 * 参数： * featureId - [IN] 产品的特征项ID。 * pCapacity - [OUT] 特征项剩余容量。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS QueryFeature(BIT_UINT32 featureId, BIT_UINT32 *pCapacity); /** * 释放“用户”类型特征项的用户数，并返回剩余容量。 * 参数： * featureId - [IN] 产品的特征项ID。 * pCapacity - [OUT] 特征项剩余容量。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS ReleaseFeature(BIT_UINT32 featureId, BIT_UINT32 *pCapacity); /** * 创建或更新配置项。如果相同名称的配置项存在，则会更新其中的数据；否则将添加新的授权码配置项。 * 参数： * szDataItemName - [IN] 数据项名称，名称最大长度为128字节。 * pDataItemValue - [IN] 数据项数据缓存区地址，数据最大长度为1024字节。 * dataItemValueSize - [IN] 数据项长度。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS SetDataItem(BIT_PCSTR szDataItemName, BIT_PCSTR szDataValue); /** * 删除指定的配置项。该操作无法删除在比特平台上设置的产品配置项或模版配置项。 * 参数： * szDataItemName - [IN] 数据项名称，名称最大长度为128字节。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS RemoveDataItem(BIT_PCSTR szDataItemName); /** * 读取指定的配置项数据。 * 参数： * szDataItemName - [IN] 数据项名称，名称最大长度为128字节。 * dataValue - [OUT] 数据项数据缓存区地址，数据最大长度为1024字节。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS GetDataItem(BIT_PCSTR szDataItemName, string& dataValue); /** * 此函数用于获取可访问配置项的数量，一般用于配置项的枚举操作。 * 参数： * pNumber - [OUT] 可访问的数据项总数，包括了所有可以访问到的产品、模版及授权码的数据项。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS GetDataItemNum(BIT_UINT32 *pNumber); /** * 根据配置项索引获取其名称，一般用于配置项的枚举操作。 * 参数： * index - [IN] 数据项索引。 * dataName - [OUT] 用于存储数据项名称的存储区地址。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS GetDataItemName(BIT_UINT32 index, string &dataName); /** * 获取当前会话信息。根据获取的内容不同，此函数返回的数据可能是XML格式或非XML格式。 * 参数： * type - [IN] 获取会话信息类型。 * sessionInfo - [OUT] 返回的结果存放位置。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS GetSessionInfo(SESSION_TYPE type, string &sessionInfo); /** * 获取当前运行环境的升级请求码，用于发起本地授权激活及升级请求。 * 参数： * szSN - [IN] 授权码（SN），由比特平台产生，不能为空，必须输入 * type - [IN] 本地授权绑定类型。 包含以下类型： * BINDING_EXISTING // 使用当前绑定类型，仅适用于授权码已经存在于本机或USB存储器 * BINDING_LOCAL // 使用本机指纹进行绑定 * BINDING_USB_STORAGE // 使用USB存储器进行绑定 * requestInfo - [OUT] 用于存储请求码的存储区地址。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS GetRequestInfo(BIT_PCSTR szSN, BINDING_TYPE type, string& requestInfo); /** * 使用请求码与授权服务器进行连接，获取升级码。本函数需要进行网络连接。 * 参数： * szSN - [IN] 授权码（SN），由比特平台产生。 * pRequestInfo - [IN] 由获取请求码函数得到的请求码。 * updateInfo - [OUT] 由授权服务器获得的本地授权升级码。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS GetUpdateInfo(BIT_PCSTR szSN, BIT_PCSTR requestInfo, string &updateInfo); /** * 应用升级码完成本地授权激活或升级。本函数必须在获取请求码的同一环境下执行。 * 参数： * pUpdateInfo - [IN] 由授权服务器获得的本地授权升级码。 * receiptInfo - [OUT] 确认码，记录升级状态，可由比特平台进行解析。为NULL表示不返回确认码 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS ApplyUpdateInfo(BIT_PCSTR pUpdateInfo, string& receiptInfo); /** * 此函数用于与授权服务器在线连接，自动完成本地授权的升级操作。本函数需要进行网络连接。 * 参数： * szSN - [IN] 授权码（SN），为空表示升级第一个可用的授权码，但是如果授权码是迁出状态，不能为空 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS UpdateOnline(BIT_PCSTR szSN); /** * 此函数用于完成授权的在线迁出，迁出以后，其他机器就可以用了。本函数需要进行网络连接。 * 参数： * szSN - [IN] 授权码（SN），为空表示迁出第一个可用的授权码。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS RevokeOnline(BIT_PCSTR szSN); /** * 此函数用于与产生授权的离线迁出请求码。本函数可能需要进行网络连接。 * 参数： * szSN - [IN] 授权码（SN），不能为空 * revokeInfo - [OUT] 存放迁出请求码的存储区地址 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS Revoke(BIT_PCSTR szSN, string& revokeInfo); /** * 此函数用于获取授权码或集团服务等的相关信息，调用前不需要登录。 * 参数： * szSerialNum - [IN] 授权码 * type - [IN] 获取信息类型。 * info - [OUT] 存放信息结果的存储区地址 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS GetInfo(BIT_PCSTR szSN, BIT_INFO_TYPE type, string& info); /** * 此函数用于设置集团服务的地址和端口。 * 参数： * szHostName - [IN] 集团服务器的地址，可以为域名或IP * nPort - [IN] 集团服务器的端口 * nTimeoutSeconds - [IN] 连接服务器超时时间，单位秒 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS SetLocalServer(BIT_PCSTR szHostName, BIT_UINT32 nPort, BIT_UINT32 nTimeoutSeconds); /** * 此函数用于设置代理服务的地址和端口。 * 参数： * szHostName - [IN] 代理服务器的地址，可以为域名或IP * nPort - [IN] 代理服务器的端口 * szUserID - [IN] 连接代理服务器的用户名 * szPassword - [IN] 连接代理服务器的密码 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS SetProxy(BIT_PCSTR szHostName, BIT_UINT32 nPort, BIT_PCSTR szUserID, BIT_PCSTR szPassword); /** * 此函数用于获取授权存储目录 * 参数： * path - [OUT] 产品的存储路径 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS GetProductPath(string &path); /** * 此函数用于删除本地授权。 * 参数： * szSN - [IN] 授权码 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS RemoveSn(BIT_PCSTR szSN); /** * 获取授权信息及使用环境信息，数据以XML格式返回。调用此函数前客户端不需要执行登录操作。 * 参数： * szSN - [IN] 授权码（SN）字符串 * type - [IN] 获取信息类型。 包含以下类型： * BIT_INFO_SERVER_ADDRESS // 获取局域网内的集团授权服务器地址列表 * BIT_INFO_SN // 获取本机已激活的授权码列表 * BIT_INFO_SN_FEATURE // 获取本机已激活授权码的特征项列表 * BIT_INFO_SN_LICENSE // 获取本机已激活授权码的授权信息 * BIT_INFO_UPDATE_ERROR // 获取指定授权码的升级错误详细信息。是否存在详细信息由授权码类型及错误类型决定 * pInfo - [OUT] 用于存储返回XML信息数据的存储区地址。 * pInfoSize - [IN/OUT] 输入的存储区长度。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS GetInfo(BIT_PCSTR szSN, BIT_INFO_TYPE type, BIT_CHAR *pInfo, BIT_UINT32 *pInfoSize); /** * 获取客户端安全库版本号。 * 参数： * pVersion - [OUT] 客户端安全库版本号。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS GetVersion(BIT_UINT32 *pVersion); /** * 从集团授权服务器借出一个完整的授权码，以允许客户端脱离集团服务器单独使用。 * 被借出的集团授权码必须具有可借出属性，并在客户端成功借出后减少一个可用用户数。 * 被借出的用户数在到期后将自动返还给集团服务器。 * 参数： * szURL - [IN] 集团授权服务器地址，包括端口。如输入NULL，则使用配置文件地址；如输入 * 号，则使用广播查找地址。 * featureId - [IN] 指定借出授权码需要包含的特征项ID，为 0 则寻找第一个可借出授权码。 * nDurationDays - [IN] 借出时间，单位为天。借出时间不能超过被借出集团授权的强制认证周期或有效期。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS CheckOutSn(BIT_PCSTR szURL, BIT_UINT32 featureId, BIT_UINT32 nDurationDays); /** * 从集团授权服务器借出一组特征项，这些特征项必须包含在同一个授权码中。 * 被借出的集团授权码必须具有可借出属性，并在客户端成功借出后减少一个可用用户数。 * 被借出的用户数在到期后将自动返还给集团服务器。 * 参数： * szURL - [IN] 集团授权服务器地址，包括端口。如输入NULL，则使用配置文件地址；如输入 * 号，则使用广播查找地址。 * pFeatureList - [IN] 要借出的特征项列表。 * nFeatureInList - [IN] 要借出的特征项数量。 * nDurationDays - [IN] 借出时间，单位为天。借出时间不能超过被借出集团授权的强制认证周期或有效期。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS CheckOutFeatures(BIT_PCSTR szURL, BIT_UINT32 *pFeatureList, BIT_UINT32 nFeatureInList, BIT_UINT32 nDurationDays); /** * 提前返还从集团授权服务器借出的授权。要提前返还授权，该授权码必须具有允许提前返还属性。 * 参数： * szURL - [IN] 集团授权服务器地址，包括端口。如输入NULL，则使用配置文件地址；如输入 * 号，则使用广播查找地址。 * featureId - [IN] 指定要返还授权码需要包含的特征项ID，为 0 则寻找第一个可返还授权码。 * 返回： * 如果返回值为零，表示此函数调用成功。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS CheckIn(BIT_PCSTR szURL, BIT_UINT32 featureId); /** * 测试集团授权和特征项是否可用，不会占用授权码或特征项的用户数。 * 参数： * szURL - [IN] 集团授权服务器地址，包括端口。 * szSN - [IN] 授权码（SN），为空表示不指定授权码。 * featureId - [IN] 指定要测试的特征项，为 0 则不检查特征项。 * 返回： * 如果返回值为零，表示指定的授权码和特征项可用。如果非零，可以根据返回值，从错误码表中查看具体的错误原因。 */ BIT_STATUS TestBitService(BIT_PCSTR szURL, BIT_PCSTR szSN, BIT_UINT32 featureId); };