设备网络SDK开发使用手册

NET_DVR_StartRemoteConfig

启动远程配置。

LONG NET_DVR_StartRemoteConfig(
  LONG                     lUserID,
  DWORD                    dwCommand,
  LPVOID                   lpInBuffer,
  DWORD                    dwInBufferLen,
  fRemoteConfigCallback    cbStateCallback,
  LPVOID                   pUserData
);

Parameters

lUserID

[in] NET_DVR_Login_V40等登录接口的返回值

dwCommand

[in] 配置命令，不同的功能对应不同的命令号(dwCommand)，lpInBuffer等参数也对应不同的内容，如下表所示：

dwCommand宏定义	宏定义值	含义	lpInBuffer	cbStateCallback
NET_DVR_GET_CARD_CFG_V50	2178	获取卡参数(V50扩展，兼容老命令)	NET_DVR_CARD_CFG_COND	返回状态、信息数据
NET_DVR_SET_CARD_CFG_V50	2179	设置卡参数(V50扩展，兼容老命令)	NET_DVR_CARD_CFG_COND	返回状态
NET_DVR_GET_CARD_CFG	2116	获取卡参数(老命令，建议使用V50扩展命令)	NET_DVR_CARD_CFG_COND	返回状态、信息数据
NET_DVR_SET_CARD_CFG	2117	设置卡参数(老命令，建议使用V50扩展命令)	NET_DVR_CARD_CFG_COND	返回状态
NET_DVR_GET_FINGERPRINT_CFG	2150	获取指纹参数	NET_DVR_FINGER_PRINT_INFO_COND	返回状态、信息数据
NET_DVR_SET_FINGERPRINT_CFG	2151	设置指纹参数	NET_DVR_FINGER_PRINT_INFO_COND	返回状态、信息数据
NET_DVR_GET_CARD_PASSWD_CFG	2161	获取卡密码开门使能参数	NET_DVR_CARD_CFG_COND	返回状态、信息数据
NET_DVR_SET_CARD_PASSWD_CFG	2162	设置卡密码开门使能参数	NET_DVR_CARD_CFG_COND	返回状态、信息数据

lpInBuffer

[in] 输入参数，具体内容跟配置命令相关

dwInBufferLen

[in] 输入缓冲的大小

cbStateCallback

[in] 状态回调函数

pUserData

[in] 用户数据

Callback Function

typedef void(CALLBACK *fRemoteConfigCallback)(
  DWORD    dwType,
  void     *lpBuffer,
  DWORD    dwBufLen,
  void     *pUserData
);

Callback Function Parameters

dwType

[out] 配置状态，具体定义如下所示：

enum _NET_SDK_CALLBACK_TYPE_{
  NET_SDK_CALLBACK_TYPE_STATUS   = 0,
  NET_SDK_CALLBACK_TYPE_PROGRESS,
  NET_SDK_CALLBACK_TYPE_DATA
}NET_SDK_CALLBACK_TYPE

NET_SDK_CALLBACK_TYPE_STATUS: 回调状态值
NET_SDK_CALLBACK_TYPE_PROGRESS: 回调进度值(暂不支持)
NET_SDK_CALLBACK_TYPE_DATA: 回调数据内容

lpBuffer

[out] 存放数据的缓冲区指针，具体内容跟dwType相关，详见列表

dwType	含义	lpBuffer对应内容
NET_SDK_CALLBACK_TYPE_STATUS	状态值	前4个字节为状态值(dwStatus)： dwStatus为NET_SDK_CALLBACK_STATUS_SUCCESS，表示获取和配置成功并且结束； dwStatus为NET_SDK_CALLBACK_STATUS_PROCESSING，lpBuffer：4字节状态 + 32字节卡号； dwStatus为NET_SDK_CALLBACK_STATUS_FAILED，lpBuffer：4字节状态 + 4字节错误码 + 32字节卡号； dwStatus为NET_SDK_CALLBACK_STATUS_EXCEPTION，表示长连接配置异常 dwStatus为NET_SDK_CALLBACK_STATUS_LANGUAGE_MISMATCH,表示（IPC配置文件导入）语言不匹配 dwStatus为NET_SDK_CALLBACK_STATUS_DEV_TYPE_MISMATCH,表示（IPC配置文件导入）设备类型不匹配 dwStatus为NET_DVR_CALLBACK_STATUS_SEND_WAIT，表示需要等待一段时间再发送
NET_SDK_CALLBACK_TYPE_PROGRESS	进度值	lpBuffer的值表示进度(DWORD)
NET_SDK_CALLBACK_TYPE_DATA	信息数据	lpBuffer的值表示信息数据 NET_DVR_GET_CARD_CFG时，对应结构体：NET_DVR_CARD_CFG NET_DVR_GET_CARD_CFG_V50时，对应结构体：NET_DVR_CARD_CFG_V50 NET_DVR_GET_FINGERPRINT_CFG时，对应结构体：NET_DVR_FINGER_PRINT_CFG NET_DVR_SET_FINGERPRINT_CFG时，对应结构体：NET_DVR_FINGER_PRINT_STATUS NET_DVR_GET_CARD_PASSWD_CFG时，对应结构体：NET_DVR_CARD_PASSWD_CFG NET_DVR_SET_CARD_PASSWD_CFG时，对应结构体：NET_DVR_CARD_PASSWD_STATUS

dwBufLen

[out] 缓冲区大小

pUserData

[out] 用户数据

Return Values

-1表示失败，其他值作为NET_DVR_SendRemoteConfig等接口的句柄。接口返回失败请调用NET_DVR_GetLastError获取错误码，通过错误码判断出错原因。

Remarks

NET_DVR_GET_CARD_CFG获取卡参数时，在调用该接口启动长连接远程配置后，还需要调用NET_DVR_SendRemoteConfig发送查找条件数据(获取所有卡参数时不需要调用该发送接口)，查找结果在NET_DVR_StartRemoteConfig设置的回调函数中返回。NET_DVR_SET_CARD_CFG设置卡参数时，在调用该接口启动长连接远程配置后，通过调用NET_DVR_SendRemoteConfig向设备下发卡参数信息。
NET_DVR_GET_FINGERPRINT_CFG获取指纹参数时，调用该接口启动查询，查找结果在NET_DVR_StartRemoteConfig设置的回调函数中返回。NET_DVR_SET_FINGERPRINT_CFG设置指纹参数时，在调用该接口启动长连接远程配置后，通过调用NET_DVR_SendRemoteConfig向设备下发指纹参数信息，在NET_DVR_StartRemoteConfig设置的回调函数中返回状态信息。
NET_DVR_GET_CARD_PASSWD_CFG获取卡密码开门使能参数时，在调用该接口启动长连接远程配置后，还需要调用NET_DVR_SendRemoteConfig发送查找条件数据(获取所有卡信息时不需要调用该发送接口)，查找结果在NET_DVR_StartRemoteConfig设置的回调函数中返回。NET_DVR_SET_CARD_PASSWD_CFG设置卡密码开门使能参数时，在调用该接口启动长连接远程配置后，通过调用NET_DVR_SendRemoteConfig向设备下发卡密码开门使能信息，在NET_DVR_StartRemoteConfig设置的回调函数中返回状态信息。
发送接口支持单个NET_DVR_CARD_CFG_SEND_DATA和NET_DVR_CARD_CFG结构体发送，获取所有卡参数时不需要调用发送接口。当发送接口返回失败时，调用NET_DVR_GetRemoteConfigState获取长连接状态，状态值为NET_DVR_CALLBACK_STATUS_SEND_WAIT则需等待一段时间发送，当状态值为NET_SDK_CALLBACK_STATUS_PROCESSING时，可以再次调用发送接口发送数据。
下发卡参数时，如果将byCheckCardNo置为0，那么设备将不校验应用层下发的卡号信息，直接写入本地存储，需要上层应用保证卡号信息不重复，可以一定程度提高卡号下发的速度。
当状态值为 NET_SDK_CALLBACK_STATUS_SUCCESS 和NET_SDK_CALLBACK_STATUS_PROCESSING，没有错误码返回，返回当前处理到的卡号。当状态值为 NET_SDK_CALLBACK_STATUS_FAILED ，返回相应的错误码信息、卡号信息，错误码数据量和发送结构体数量一致对应。