Bit_UpdateOnline

BIT_STATUS Bit_UpdateOnline (
    BIT_PCSTR      szURL,
    BIT_PCSTR      szSN,
    BIT_UCHAR      *pApplicationData)

此函数用于与授权服务器在线连接，自动完成本地授权的升级操作。本函数需要进行网络连接。

参数

• szURL - [IN] 自定义授权服务器地址，包括端口。如未使用自定义授权服务器则为NULL。
• szSN - [IN] 该参数可以传入授权码；激活口令；帐号密码；BIT-ID序号。传入方式参考Bit_Login的szSN参数说明。
• pApplicationData - [IN] 产品识别码。记录在接口定义文件中，与产品一一对应。

示例

BIT_CHAR *pSn = “<授权码>”;
BIT_STATUS status = Bit_UpdateOnline(“”,  pSn,  application_data);
if (status == BIT_SUCCESS) {
    // 激活或升级成功
}

Bit_GetRequestInfo

BIT_STATUS Bit_GetRequestInfo (
    BIT_PCSTR      szSN,
    BIT_UCHAR      *pApplicationData,
    BINDING_TYPE   type,
    BIT_CHAR       *pRequestInfo,
    BIT_UINT32     *pRequestInfoSize)

获取当前运行环境的升级请求码，用于发起本地授权激活及升级请求。如果第一次调用返回错误码260，说明传入的pRequestInfoSize太小，可传入返回的pRequestInfoSize再重新调用一次。

参数

• szSN - [IN] 授权码（SN）字符串。如果为空（空串或NULL）则尝试寻找所有当前本机可用的SN。
• pApplicationData - [IN] 产品识别码。记录在接口定义文件中，与产品一一对应。
• type - [IN] 获取请求码的类型。

• pRequestInfo - [OUT] 用于存储请求码的存储区地址。
• pRequestInfoSize - [IN/OUT] 输入时为请求码存储区大小，输出时为请求码长度。

示例

// 获取请求串
BIT_CHAR *pSn = “<授权码>”;
BIT_CHAR buff[1024] = { 0 };
BIT_UINT32 len = sizeof(buff);
BIT_STATUS status = Bit_GetRequestInfo (pSn, application_data, BINDING_LOCAL, buff, &len);
if (status == BIT_SUCCESS) {
    // 请求串保存在buff里
}

// 获取设备码
BIT_STATUS status = Bit_GetRequestInfo (NULL, application_data, REQ_TYPE_MID, buff, &len);
if (status == BIT_SUCCESS) {
    // 设备码保存在buff里
}

Bit_ApplyUpdateInfo

BIT_STATUS BIT_CALLCONV Bit_ApplyUpdateInfo(
    BIT_UCHAR      *pApplicationData,
    BIT_PCSTR      pUpdateInfo,
    BIT_CHAR       *pReceipt,
    BIT_UINT32     *pReceiptSize)

应用升级码完成本地授权激活或升级。本函数必须在获取请求码的同一环境下执行。

参数

• pApplicationData - [IN] 产品识别码。记录在接口定义文件中，与产品一一对应。
• pUpdateInfo - [IN] 由授权服务器获得的本地授权升级码。
• pReceiptInfo - [OUT] 确认码，记录升级状态，可在控制台上解析。
• pReceiptInfoSize - [IN/OUT] 输入时为存储区大小，输出时为确认码长度。

示例

// 获取请求串
BIT_CHAR *pUpdateInfo = “<升级串>”;
BIT_CHAR buff[1024] = { 0 };
BIT_UINT32 len = sizeof(buff);

BIT_STATUS status = Bit_ApplyUpdateInfo(application_data, pUpdateInfo, buff, &len);
if (status == BIT_SUCCESS) {
    // 升级串使用成功，Buff里保存的是确认串
}

Bit_ApplyUpdateInfoEx

BIT_STATUS BIT_CALLCONV Bit_ApplyUpdateInfoEx(
    BIT_CHAR       *pScope,
    BIT_UCHAR      *pApplicationData,
    BIT_PCSTR      pUpdateInfo,
    BIT_CHAR       *pReceipt,
    BIT_UINT32     *pReceiptSize);

应用升级码完成远程集团授权激活或升级。一般不建议使用。

参数

• pScope - [IN] 集团服务的URL。
• pApplicationData - [IN] 产品识别码。记录在接口定义文件中，与产品一一对应。
• pUpdateInfo - [IN] 由授权服务器获得的本地授权升级码。
• pReceiptInfo - [OUT] 确认码，记录升级状态，可在控制台上解析。pReceiptInfoSize - [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] 输入时为存储区大小，输出时为升级码长度。