|
方法摘要 |
BIT_STATUS |
Bit_Login(BIT_PCSTR szURL, BIT_PCSTR szSN, BIT_UCHAR * pApplicationData, BIT_HANDLE * pHandle, LOGIN_MODE mode)
授权登录。初始化运行环境,获取操作句柄。必须在除升级函数之外的其它操作前执行。根据登录模式的不同可能需要连接授权服务器。
|
BIT_STATUS |
Bit_LoginEx(BIT_PCSTR szURL, BIT_PCSTR szSN, BIT_UINT32 featureId, BIT_PCSTR xmlScope, BIT_UCHAR * pApplicationData, BIT_HANDLE * pHandle, LOGIN_MODE mode)
授权登录的增强版本。允许应用程序在登录时指定授权中所需包含的特征项,以缩小登录范围。
|
BIT_STATUS |
Bit_Logout(BIT_HANDLE handle)
此函数用于释放上下文句柄,退出登录状态。
|
BIT_STATUS |
Bit_ReadFeature(BIT_HANDLE handle, BIT_UINT32 featureId, BIT_UINT32 * pFeatureValue)
此函数用于读取特征项的数据内容,可用于“只读”和“读写”特征类型。
|
BIT_STATUS |
Bit_WriteFeature(BIT_HANDLE handle, BIT_UINT32 featureId, BIT_UINT32 featureValue)
此函数用于更新“读写”类型的特征项的数据内容。
|
BIT_STATUS |
Bit_ConvertFeature(BIT_HANDLE handle, BIT_UINT32 featureId, BIT_UINT32 para1, BIT_UINT32 para2, BIT_UINT32 para3, BIT_UINT32 para4, BIT_UINT32 * pResult)
此函数用于使用“算法”类型的特征项对输入参数进行变换操作,得到唯一对应的4字节结果。
|
BIT_STATUS |
Bit_EncryptFeature(BIT_HANDLE handle, BIT_UINT32 featureId, BIT_VOID * pPlainBuffer, BIT_VOID * pCipherBuffer, BIT_UINT32 dataBufferSize)
此函数用于使用“密钥”类型的特征项对输入的明文进行加密,返回密文结果。
|
BIT_STATUS |
Bit_DecryptFeature(BIT_HANDLE handle, BIT_UINT32 featureId, BIT_VOID * pCipherBuffer, BIT_VOID * pPlainBuffer, BIT_UINT32 dataBufferSize)
此函数用于使用“密钥”类型的特征项对输入的密文进行解密,返回明文结果。
|
BIT_STATUS |
Bit_QueryFeature(BIT_HANDLE handle, BIT_UINT32 featureId, BIT_UINT32 * pCapacity)
请求特征项,检查特征项是否存在并可用。可用于任意特征项类型。对于集团授权,函数执行成功后会占用一个模块用户数。
|
BIT_STATUS |
Bit_ReleaseFeature(BIT_HANDLE handle, BIT_UINT32 featureId, BIT_UINT32 * pCapacity)
释放特征项。集团授权会释放模块用户数。
|
BIT_STATUS |
Bit_SetDataItem(BIT_HANDLE handle, BIT_PCSTR szDataItemName, BIT_VOID * pDataItemValue, BIT_UINT32 dataItemValueSize)
创建或更新配置项。如果相同名称的配置项存在,则会更新其中的数据;否则将添加新的授权码配置项。
|
BIT_STATUS |
Bit_RemoveDataItem(BIT_HANDLE handle, BIT_PCSTR szDataItemName)
删除指定的配置项。该操作无法删除通过控制台设置的产品配置项或模版配置项。
|
BIT_STATUS |
Bit_GetDataItem(BIT_HANDLE handle, BIT_PCSTR szDataItemName, BIT_VOID * pDataItemValue, BIT_UINT32 * pDataItemValueSize)
读取指定的配置项数据。
|
BIT_STATUS |
Bit_GetDataItemNum(BIT_HANDLE handle, BIT_UINT32 * pNum)
此函数用于获取可访问配置项的数量,一般用于配置项的枚举操作。
|
BIT_STATUS |
Bit_GetDataItemName(BIT_HANDLE handle, BIT_UINT32 index, BIT_CHAR * pDataItemName, BIT_UINT32 * pDataItemNameSize)
根据配置项索引获取其名称,一般用于配置项的枚举操作。
|
BIT_STATUS |
Bit_GetSessionInfo(BIT_HANDLE handle, SESSION_TYPE type, BIT_CHAR * pSessionInfo, BIT_UINT32 * pSessionInfoSize)
获取当前会话信息,以字符串形式返回。根据获取的内容不同,返回结果可能是XML格式或非XML格式。
返回数据中的日期项已根据客户端的本地时区进行调整。如果Login时未指定SN,返回串为当前系统所有可用SN的综合结果。
|
BIT_STATUS |
Bit_GetFeatureInfo(BIT_HANDLE handle, BIT_UINT32 featureId, BIT_FEATURE_INFO * pFeatureInfo)
获取指定特征项的信息。
|
BIT_STATUS |
Bit_GetRequestInfo(BIT_PCSTR szSN, BIT_UCHAR * pApplicationData, BINDING_TYPE type, BIT_CHAR * pRequestInfo, BIT_UINT32 * pRequestInfoSize)
获取当前运行环境的升级请求码,用于发起本地授权激活及升级请求。
|
BIT_STATUS |
Bit_GetUpdateInfo(BIT_PCSTR szURL, BIT_PCSTR szSN, BIT_UCHAR * pApplicationData, BIT_PCSTR pRequestInfo, BIT_CHAR * pUpdateInfo, BIT_UINT32 * pUpdateInfoSize)
使用请求码与授权服务器进行连接,获取升级码。本函数需要进行网络连接。
|
BIT_STATUS |
Bit_ApplyUpdateInfo(BIT_UCHAR * pApplicationData, BIT_PCSTR pUpdateInfo, BIT_CHAR * pReceiptInfo, BIT_UINT32 * pReceiptInfoSize)
应用升级码完成本地授权激活或升级。本函数必须在获取请求码的同一环境下执行。
|
BIT_STATUS |
Bit_UpdateOnline(BIT_PCSTR szURL, BIT_PCSTR szSN, BIT_UCHAR * pApplicationData)
此函数用于与授权服务器在线连接,自动完成本地授权的升级操作。本函数需要进行网络连接。
|
BIT_STATUS |
Bit_Revoke(BIT_PCSTR szURL, BIT_PCSTR szSN, BIT_UCHAR * pApplicationData, BIT_CHAR * pRevocationInfo, BIT_UINT32 * pRevocationInfoSize)
从客户端迁出已激活的浮动授权码。授权码迁出后,可以用于其它的客户端。根据输入参数的不同,本函数可用于在线或离线迁出。
|
BIT_STATUS |
Bit_CheckOutSn(BIT_PCSTR szURL, BIT_UINT32 featureId, BIT_UCHAR * pApplicationData, BIT_UINT32 nDurationDays)
从集团授权服务器借出一个完整的授权码,以允许客户端脱离集团服务器单独使用。被借出的集团授权码必须具有可借出属性,并在客户端成功借出后减少一个可用用户数。被借出的用户数在到期后将自动返还给集团服务器。
|
BIT_STATUS |
Bit_CheckOutFeatures(BIT_PCSTR szURL, BIT_UCHAR * pApplicationData, BIT_UINT32 * pFeatureList, BIT_UINT32 nFeatureInList, BIT_UINT32 nDurationDays)
从集团授权服务器借出一组特征项,这些特征项必须包含在同一个授权码中。被借出的集团授权码必须具有可借出属性,并在客户端成功借出后减少一个可用用户数。被借出的用户数在到期后将自动返还给集团服务器。
|
BIT_STATUS |
Bit_CheckIn(BIT_PCSTR szURL, BIT_UINT32 featureId, BIT_UCHAR * pApplicationData)
提前返还从集团授权服务器借出的授权。要提前返还授权,该授权码必须具有允许提前返还属性。
|
BIT_STATUS |
Bit_GetInfo(BIT_PCSTR szSN, BIT_UCHAR * pApplicationData, INFO_TYPE type, BIT_CHAR * pInfo, BIT_UINT32 * pInfoSize)
获取授权信息及使用环境信息,数据以XML格式返回。调用此函数前客户端不需要执行登录操作。
|
BIT_STATUS |
Bit_RemoveSn(BIT_PCSTR szSN, BIT_UCHAR * pApplicationData)
删除指定授权码在本机的授权数据,可用于测试或当授权数据出现问题而不能通过升级解决时的故障处理。
|
BIT_STATUS |
Bit_SetCustomInfo(BIT_UINT32 infoId, BIT_PCSTR pInfoData, BIT_UINT32 infoDataSize)
设置客户端运行自定义信息,需要在可能使用自定义信息的API(如Login)前调用。
|
BIT_STATUS |
Bit_GetVersion(BIT_UINT32 * pVersion)
获取客户端安全库版本号。
|
Bit_Login
BIT_STATUS Bit_Login (
BIT_PCSTR szURL,
BIT_PCSTR szSN,
BIT_UCHAR * pApplicationData,
BIT_HANDLE * pHandle,
LOGIN_MODE mode)
- 授权登录。初始化运行环境,获取操作句柄。必须在除升级函数之外的其它操作前执行。根据登录模式的不同可能需要连接授权服务器。
-
- 参数:
-
szURL - [IN] 自定义授权服务器地址,包括端口。如未使用自定义授权服务器则为NULL。
-
szSN - [IN] 授权码(SN)字符串。如果为空(空串或NULL)则尝试寻找所有当前本机可用的SN
-
pApplicationData - [IN] 产品识别码。记录在接口定义文件中,与产品一一对应。
-
pHandle - [OUT] 通过Login函数返回的上下文句柄。
-
mode - [IN] 登录模式。 包含以下类型:
- BIT_MODE_LOCAL // 登录本地授权,不会尝试寻找集团或云授权服务器。如果本地授权失效也不会尝试自动升级
- BIT_MODE_REMOTE // 登录远程授权服务器,尝试建立云授权或集团授权连接,服务器地址由URL参数或配置文件提供
- BIT_MODE_AUTO // 同时尝试本地授权及远程授权,寻找任何可用的授权方式。可能自动升级失效的本地授权
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_LoginEx
BIT_STATUS Bit_LoginEx (
BIT_PCSTR szURL,
BIT_PCSTR szSN,
BIT_UINT32 featureId,
BIT_PCSTR xmlScope,
BIT_UCHAR * pApplicationData,
BIT_HANDLE * pHandle,
LOGIN_MODE mode)
- 授权登录的增强版本。允许应用程序在登录时指定授权中所需包含的特征项,以缩小登录范围。
-
- 参数:
-
szURL - [IN] 自定义授权服务器地址,包括端口。如未使用自定义授权服务器则为NULL。
-
szSN - [IN] 授权码(SN)字符串。如果为空(空串或NULL)则尝试寻找所有当前本机可用的SN
-
featureId - [IN] 登录授权所需要包含的特征项ID
-
xmlScope - [IN] 登录范围。用于提供更多的登录条件,格式为标准XML字符串。目前保留,必须为NULL
-
pApplicationData - [IN] 产品识别码。记录在接口定义文件中,与产品一一对应。
-
pHandle - [OUT] 通过Login函数返回的上下文句柄。
-
mode - [IN] 登录模式。 包含以下类型:
- BIT_MODE_LOCAL // 登录本地授权,不会尝试寻找集团或云授权服务器。如果本地授权失效也不会尝试自动升级
- BIT_MODE_REMOTE // 登录远程授权服务器,尝试建立云授权或集团授权连接,服务器地址由URL参数或配置文件提供
- BIT_MODE_AUTO // 同时尝试本地授权及远程授权,寻找任何可用的授权方式。可能自动升级失效的本地授权
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_Logout
BIT_STATUS Bit_Logout (
BIT_HANDLE handle)
- 此函数用于释放上下文句柄,退出登录状态。
-
- 参数:
-
handle - [IN] 通过Login函数返回的上下文句柄。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_ReadFeature
BIT_STATUS Bit_ReadFeature (
BIT_HANDLE handle,
BIT_UINT32 featureId,
BIT_UINT32 * pFeatureValue)
- 此函数用于读取特征项的数据内容,可用于“只读”和“读写”特征类型。
-
- 参数:
-
handle - [IN] 通过Login函数返回的上下文句柄。
-
featureId - [IN] 产品的特征项ID。
-
pFeatureValue - [OUT] 特征项数据缓存区地址,用于存储读出的数据。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_WriteFeature
BIT_STATUS Bit_WriteFeature (
BIT_HANDLE handle,
BIT_UINT32 featureId,
BIT_UINT32 featureValue)
- 此函数用于更新“读写”类型的特征项的数据内容。
-
- 参数:
-
handle - [IN] 通过Login函数返回的上下文句柄。
-
featureId - [IN] 产品的特征项ID。
-
featureValue - [IN] 特征项数据值。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_ConvertFeature
BIT_STATUS Bit_ConvertFeature (
BIT_HANDLE handle,
BIT_UINT32 featureId,
BIT_UINT32 para1,
BIT_UINT32 para2,
BIT_UINT32 para3,
BIT_UINT32 para4,
BIT_UINT32 * pResult)
- 此函数用于使用“算法”类型的特征项对输入参数进行变换操作,得到唯一对应的4字节结果。
-
- 参数:
-
handle - [IN] 通过Login函数返回的上下文句柄。
-
featureId - [IN] 产品的特征项ID。
-
para1 - [IN] 变换输入因子1
-
para2 - [IN] 变换输入因子2
-
para3 - [IN] 变换输入因子3
-
para4 - [IN] 变换输入因子4
-
pResult - [OUT] 变换结果。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_EncryptFeature
BIT_STATUS Bit_EncryptFeature (
BIT_HANDLE handle,
BIT_UINT32 featureId,
BIT_VOID * pPlainBuffer,
BIT_VOID * pCipherBuffer,
BIT_UINT32 dataBufferSize)
- 此函数用于使用“密钥”类型的特征项对输入的明文进行加密,返回密文结果。
-
- 参数:
-
handle - [IN] 通过Login函数返回的上下文句柄。
-
featureId - [IN] 产品的特征项ID。
-
pPlainBuffer - [IN] 数据缓存区地址,用于存储明文数据。
-
pCipherBuffer - [OUT] 数据缓存区地址,用于存储密文数据。
-
dataBufferSize - [IN] 数据长度,最大长度为256字节。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_DecryptFeature
BIT_STATUS Bit_DecryptFeature (
BIT_HANDLE handle,
BIT_UINT32 featureId,
BIT_VOID * pCipherBuffer,
BIT_VOID * pPlainBuffer,
BIT_UINT32 dataBufferSize)
- 此函数用于使用“密钥”类型的特征项对输入的密文进行解密,返回明文结果。
-
- 参数:
-
handle - [IN] 通过Login函数返回的上下文句柄。
-
featureId - [IN] 产品的特征项ID。
-
pCipherBuffer - [IN] 数据缓存区地址,用于存储密文数据。
-
pPlainBuffer - [OUT] 数据缓存区地址,用于存储明文数据。
-
dataBufferSize - [IN] 数据长度,最大长度为256字节。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_QueryFeature
BIT_STATUS Bit_QueryFeature (
BIT_HANDLE handle,
BIT_UINT32 featureId,
BIT_UINT32 * pCapacity)
- 请求特征项,检查特征项是否存在并可用。可用于任意特征项类型。对于集团授权,函数执行成功后会占用一个模块用户数。
-
- 参数:
-
handle - [IN] 通过Login函数返回的上下文句柄。
-
featureId - [IN] 产品的特征项ID。
-
pCapacity - [OUT] 当不为NULL时,获取特征项当前可用用户数。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_ReleaseFeature
BIT_STATUS Bit_ReleaseFeature (
BIT_HANDLE handle,
BIT_UINT32 featureId,
BIT_UINT32 * pCapacity)
- 释放特征项。集团授权会释放模块用户数。
-
- 参数:
-
handle - [IN] 通过Login函数返回的上下文句柄。
-
featureId - [IN] 产品的特征项ID。
-
pCapacity - [OUT] 当不为NULL时,获取特征项当前可用用户数。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_SetDataItem
BIT_STATUS Bit_SetDataItem (
BIT_HANDLE handle,
BIT_PCSTR szDataItemName,
BIT_VOID * pDataItemValue,
BIT_UINT32 dataItemValueSize)
- 创建或更新配置项。如果相同名称的配置项存在,则会更新其中的数据;否则将添加新的授权码配置项。
-
- 参数:
-
handle - [IN] 通过Login函数返回的上下文句柄。
-
szDataItemName - [IN] 数据项名称,名称最大长度为128字节。
-
pDataItemValue - [IN] 数据项数据缓存区地址,数据最大长度为1024字节。
-
dataItemValueSize - [IN] 数据项长度。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_RemoveDataItem
BIT_STATUS Bit_RemoveDataItem (
BIT_HANDLE handle,
BIT_PCSTR szDataItemName)
- 删除指定的配置项。该操作无法删除通过控制台设置的产品配置项或模版配置项。
-
- 参数:
-
handle - [IN] 通过Login函数返回的上下文句柄。
-
szDataItemName - [IN] 数据项名称,名称最大长度为128字节。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_GetDataItem
BIT_STATUS Bit_GetDataItem (
BIT_HANDLE handle,
BIT_PCSTR szDataItemName,
BIT_VOID * pDataItemValue,
BIT_UINT32 * pDataItemValueSize)
- 读取指定的配置项数据。
-
- 参数:
-
handle - [IN] 通过Login函数返回的上下文句柄。
-
szDataItemName - [IN] 数据项名称,名称最大长度为128字节。
-
pDataItemValue - [OUT] 数据项数据缓存区地址,数据最大长度为1024字节。
-
pDataItemValueSize - [IN/OUT] 数据项长度。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_GetDataItemNum
BIT_STATUS Bit_GetDataItemNum (
BIT_HANDLE handle,
BIT_UINT32 * pNum)
- 此函数用于获取可访问配置项的数量,一般用于配置项的枚举操作。
-
- 参数:
-
handle - [IN] 通过Login函数返回的上下文句柄。
-
pNum - [OUT] 可访问的数据项总数,包括了所有可以访问到的产品、模版及授权码的数据项。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_GetDataItemName
BIT_STATUS Bit_GetDataItemName (
BIT_HANDLE handle,
BIT_UINT32 index,
BIT_CHAR * pDataItemName,
BIT_UINT32 * pDataItemNameSize)
- 根据配置项索引获取其名称,一般用于配置项的枚举操作。
-
- 参数:
-
handle - [IN] 通过Login函数返回的上下文句柄。
-
index - [IN] 数据项索引。
-
pDataItemName - [OUT] 用于存储数据项名称的存储区地址。
-
pDataItemNameSize - [IN/OUT] 数据项名称存储区大小。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_GetSessionInfo
BIT_STATUS Bit_GetSessionInfo (
BIT_HANDLE handle,
SESSION_TYPE type,
BIT_CHAR * pSessionInfo,
BIT_UINT32 * pSessionInfoSize)
- 获取当前会话信息,以字符串形式返回。根据获取的内容不同,返回结果可能是XML格式或非XML格式。
返回数据中的日期项已根据客户端的本地时区进行调整。如果Login时未指定SN,返回串为当前系统所有可用SN的综合结果。
-
- 参数:
-
handle - [IN] 通过Login函数返回的上下文句柄。
-
type - [IN] 获取会话信息类型。 包含以下类型:
- XML_TYPE_SN_INFO // 获取当前会话中授权码的授权信息,以XML结构表示。未作限制的授权项将不会返回
- XML_TYPE_FEATURE_INFO // 获取当前会话中授权码的特征项信息,以XML结构表示
- BIT_SERVER_ADDRESS // 授权服务器IP地址。只对云授权有意义,其它授权方式将返回:127.0.0.1
- BIT_SERVER_TIME // 授权服务器系统时间。如果是本地授权,将返回本机系统时间
- BIT_CONTROL_TYPE // 授权类型。是以逗号分隔的以下几种类型的组合:Group(集团授权),Smart(智能连接), Float(可浮动), Demo(演示授权), USB(U盘授权), Force(强制认证)
- BIT_VOLUME_NUMBER // 允许使用的机器数量
- BIT_START_DATE // 授权开始日期
- BIT_END_DATE // 授权结束日期
- BIT_EXPIRATION_DAYS // 授权有效期,单位为天。有效期从激活时间算起
- BIT_USAGE_NUMBER // 最大使用次数
- BIT_CONSUMED_USAGE_NUMBER // 对于设定最大使用次数的授权码,返回当前使用次数
- BIT_ACTIVATE_DATE // 授权码激活时间
- BIT_USER_LIMIT // 集团授权用户数。对其它方式的授权返回0
- BIT_LAST_UPDATE_DATE // 最后与服务器连接时间
- BIT_MAX_OFFLINE_MINUTES // 强制认证最大离线时间(分钟)
-
pSessionInfo - [OUT] 会话信息存储区地址。可以为NULL,此时仅用于获取存储区大小。
-
pSessionInfoSize - [IN/OUT] 会话存储区大小。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_GetFeatureInfo
BIT_STATUS Bit_GetFeatureInfo (
BIT_HANDLE handle,
BIT_UINT32 featureId,
BIT_FEATURE_INFO * pFeatureInfo)
- 获取指定特征项的信息。
-
- 参数:
-
handle - [IN] 通过Login函数返回的上下文句柄。
-
featureId - [IN] 产品的特征项ID。
-
pFeatureInfo - [OUT] 特征项信息。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_GetRequestInfo
BIT_STATUS Bit_GetRequestInfo (
BIT_PCSTR szSN,
BIT_UCHAR * pApplicationData,
BINDING_TYPE type,
BIT_CHAR * pRequestInfo,
BIT_UINT32 * pRequestInfoSize)
- 获取当前运行环境的升级请求码,用于发起本地授权激活及升级请求。
-
- 参数:
-
szSN - [IN] 授权码(SN)字符串。如果为空(空串或NULL)则尝试寻找所有当前本机可用的SN
-
pApplicationData - [IN] 产品识别码。记录在接口定义文件中,与产品一一对应。
-
type - [IN] 本地授权绑定类型。 包含以下类型:
- BINDING_EXISTING // 使用当前绑定类型,对已激活授权码进行升级时使用。
- BINDING_LOCAL // 使用本机指纹进行绑定
- BINDING_USB_STORAGE // 使用USB存储器进行绑定
-
pRequestInfo - [OUT] 用于存储请求码的存储区地址。
-
pRequestInfoSize - [IN/OUT] 输入时为请求码存储区大小,输出时为请求码长度。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_GetUpdateInfo
BIT_STATUS Bit_GetUpdateInfo (
BIT_PCSTR szURL,
BIT_PCSTR szSN,
BIT_UCHAR * pApplicationData,
BIT_PCSTR pRequestInfo,
BIT_CHAR * pUpdateInfo,
BIT_UINT32 * pUpdateInfoSize)
- 使用请求码与授权服务器进行连接,获取升级码。本函数需要进行网络连接。
-
- 参数:
-
szURL - [IN] 自定义授权服务器地址,包括端口。如未使用自定义授权服务器则为NULL。
-
szSN - [IN] 授权码(SN)字符串
-
pApplicationData - [IN] 产品识别码。记录在接口定义文件中,与产品一一对应。
-
pRequestInfo - [IN] 由获取请求码函数得到的请求码。
-
pUpdateInfo - [OUT] 由授权服务器获得的本地授权升级码。
-
pUpdateInfoSize - [IN/OUT] 输入时为存储区大小,输出时为升级码长度。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_ApplyUpdateInfo
BIT_STATUS Bit_ApplyUpdateInfo (
BIT_UCHAR * pApplicationData,
BIT_PCSTR pUpdateInfo,
BIT_CHAR * pReceiptInfo,
BIT_UINT32 * pReceiptInfoSize)
- 应用升级码完成本地授权激活或升级。本函数必须在获取请求码的同一环境下执行。
-
- 参数:
-
pApplicationData - [IN] 产品识别码。记录在接口定义文件中,与产品一一对应。
-
pUpdateInfo - [IN] 由授权服务器获得的本地授权升级码。
-
pReceiptInfo - [OUT] 确认码,记录升级状态,可在控制台上解析。
-
pReceiptInfoSize - [IN/OUT] 输入时为存储区大小,输出时为确认码长度。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_UpdateOnline
BIT_STATUS Bit_UpdateOnline (
BIT_PCSTR szURL,
BIT_PCSTR szSN,
BIT_UCHAR * pApplicationData)
- 此函数用于与授权服务器在线连接,自动完成本地授权的升级操作。本函数需要进行网络连接。
-
- 参数:
-
szURL - [IN] 自定义授权服务器地址,包括端口。如未使用自定义授权服务器则为NULL。
-
szSN - [IN] 授权码(SN)字符串。如果为空(空串或NULL)则尝试寻找所有当前本机可用的SN
-
pApplicationData - [IN] 产品识别码。记录在接口定义文件中,与产品一一对应。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_Revoke
BIT_STATUS Bit_Revoke (
BIT_PCSTR szURL,
BIT_PCSTR szSN,
BIT_UCHAR * pApplicationData,
BIT_CHAR * pRevocationInfo,
BIT_UINT32 * pRevocationInfoSize)
- 从客户端迁出已激活的浮动授权码。授权码迁出后,可以用于其它的客户端。根据输入参数的不同,本函数可用于在线或离线迁出。
-
- 参数:
-
szURL - [IN] 自定义授权服务器地址,包括端口。如未使用自定义授权服务器则为NULL。
-
szSN - [IN] 授权码(SN)字符串
-
pApplicationData - [IN] 产品识别码。记录在接口定义文件中,与产品一一对应。
-
pRevocationInfo - [OUT] 迁出请求码的存储区地址。为NULL表示进行在线迁出,否则API将执行手工离线迁出,请求码应发给服务器进行确认。
-
pRevocationInfoSize - [IN/OUT] 输入时为请求码存储区大小,输出时为请求码长度。如此参数为NULL,函数将选择在线迁出。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_CheckOutSn
BIT_STATUS Bit_CheckOutSn (
BIT_PCSTR szURL,
BIT_UINT32 featureId,
BIT_UCHAR * pApplicationData,
BIT_UINT32 nDurationDays)
- 从集团授权服务器借出一个完整的授权码,以允许客户端脱离集团服务器单独使用。被借出的集团授权码必须具有可借出属性,并在客户端成功借出后减少一个可用用户数。被借出的用户数在到期后将自动返还给集团服务器。
-
- 参数:
-
szURL - [IN] 集团授权服务器地址,包括端口。如输入NULL,则使用配置文件地址;如输入 * 号,则使用广播查找地址。
-
featureId - [IN] 指定借出授权码需要包含的特征项ID,为 0 则寻找第一个可借出授权码。
-
pApplicationData - [IN] 产品识别码。记录在接口定义文件中,与产品一一对应。
-
nDurationDays - [IN] 借出时间,单位为天。借出时间不能超过被借出集团授权的强制认证周期或有效期。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_CheckOutFeatures
BIT_STATUS Bit_CheckOutFeatures (
BIT_PCSTR szURL,
BIT_UCHAR * pApplicationData,
BIT_UINT32 * pFeatureList,
BIT_UINT32 nFeatureInList,
BIT_UINT32 nDurationDays)
- 从集团授权服务器借出一组特征项,这些特征项必须包含在同一个授权码中。被借出的集团授权码必须具有可借出属性,并在客户端成功借出后减少一个可用用户数。被借出的用户数在到期后将自动返还给集团服务器。
-
- 参数:
-
szURL - [IN] 集团授权服务器地址,包括端口。如输入NULL,则使用配置文件地址;如输入 * 号,则使用广播查找地址。
-
pApplicationData - [IN] 产品识别码。记录在接口定义文件中,与产品一一对应。
-
pFeatureList - [IN] 要借出的特征项列表。
-
nFeatureInList - [IN] 要借出的特征项数量。
-
nDurationDays - [IN] 借出时间,单位为天。借出时间不能超过被借出集团授权的强制认证周期或有效期。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_CheckIn
BIT_STATUS Bit_CheckIn (
BIT_PCSTR szURL,
BIT_UINT32 featureId,
BIT_UCHAR * pApplicationData)
- 提前返还从集团授权服务器借出的授权。要提前返还授权,该授权码必须具有允许提前返还属性。
-
- 参数:
-
szURL - [IN] 集团授权服务器地址,包括端口。如输入NULL,则使用配置文件地址;如输入 * 号,则使用广播查找地址。
-
featureId - [IN] 指定要返还授权码需要包含的特征项ID,为 0 则寻找第一个可返还授权码。
-
pApplicationData - [IN] 产品识别码。记录在接口定义文件中,与产品一一对应。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_GetInfo
BIT_STATUS Bit_GetInfo (
BIT_PCSTR szSN,
BIT_UCHAR * pApplicationData,
INFO_TYPE type,
BIT_CHAR * pInfo,
BIT_UINT32 * pInfoSize)
- 获取授权信息及使用环境信息,数据以XML格式返回。调用此函数前客户端不需要执行登录操作。
-
- 参数:
-
szSN - [IN] 授权码(SN)字符串
-
pApplicationData - [IN] 产品识别码。记录在接口定义文件中,与产品一一对应。
-
type - [IN] 获取信息类型。 包含以下类型:
- BIT_INFO_SERVER_ADDRESS // 获取局域网内的集团授权服务器地址列表
- BIT_INFO_SN // 获取本机已激活的授权码列表
- BIT_INFO_SN_FEATURE // 获取本机已激活授权码的特征项列表
- BIT_INFO_SN_LICENSE // 获取本机已激活授权码的授权信息
- BIT_INFO_UPDATE_ERROR // 获取指定授权码的升级错误详细信息。是否存在详细信息由授权码类型及错误类型决定
- BIT_INFO_CONFIG // 获取当前产品的配置文件信息
- BIT_INFO_TOKEN_LIST // 获取当前机器上可用的BIT-ID列表信息
-
pInfo - [OUT] 用于存储返回XML信息数据的存储区地址。
-
pInfoSize - [IN/OUT] 输入的存储区长度。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_RemoveSn
BIT_STATUS Bit_RemoveSn (
BIT_PCSTR szSN,
BIT_UCHAR * pApplicationData)
- 删除指定授权码在本机的授权数据,可用于测试或当授权数据出现问题而不能通过升级解决时的故障处理。
-
- 参数:
-
szSN - [IN] 授权码(SN)字符串
-
pApplicationData - [IN] 产品识别码。记录在接口定义文件中,与产品一一对应。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_SetCustomInfo
BIT_STATUS Bit_SetCustomInfo (
BIT_UINT32 infoId,
BIT_PCSTR pInfoData,
BIT_UINT32 infoDataSize)
- 设置客户端运行自定义信息,需要在可能使用自定义信息的API(如Login)前调用。
-
- 参数:
-
infoId - [IN] 要设置的自定义信息类型。 包含以下类型:
- CUSTOM_CLIENT_ID // 自定义客户端唯一的机器标识,该自定义标识会发送给服务器并用于今后的机器指纹匹配
- CUSTOM_ACCOUNT // 自定义客户端用户账号,用于集团服务标识客户端用户
- CUSTOM_COMMENT // 自定义客户端登录注释,用于集团服务管理员获取用户登录请求信息
-
pInfoData - [IN] 自定义信息存储区地址。
-
infoDataSize - [IN] 自定义信息长度。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
Bit_GetVersion
BIT_STATUS Bit_GetVersion (
BIT_UINT32 * pVersion)
- 获取客户端安全库版本号。
-
- 参数:
-
pVersion - [OUT] 客户端安全库版本号。
- 返回:
- 如果返回值为零,表示此函数调用成功。如果非零,可以根据返回值,从错误码表中查看具体的错误原因。
|
|