1# IExecutor 2 3 4## 概述 5 6定义执行器标准API接口。接口可用于获取执行器信息，获取凭据模版信息，注册口令，认证口令，删除口令等。 7 8**起始版本：** 3.2 9 10**相关模块：**[HdfPinAuth](_hdf_pin_auth_v10.md) 11 12 13## 汇总 14 15 16### Public 成员函数 17 18| 名称 | 描述 | 19| -------- | -------- | 20| [GetExecutorInfo](#getexecutorinfo) ([out] struct [ExecutorInfo](_executor_info_pinauth_v10.md) executorInfo) | 获取执行器信息，口令认证服务将执行器注册到用户认证框架时需要通过该接口获取对应信息。 | 21| [GetTemplateInfo](#gettemplateinfo) ([in] unsigned long templateId, [out] struct [TemplateInfo](_template_info_pinauth_v10.md) templateInfo) | 获取属性。 | 22| [OnRegisterFinish](#onregisterfinish) ([in] unsigned long[] templateIdList, [in] unsigned char[] frameworkPublicKey, [in] unsigned char[] extraInfo) | 完成执行器注册，对口令模版信息进行对账，用于删除无效的口令模板及相关信息。 | 23| [OnSetData](#onsetdata) ([in] unsigned long scheduleId, [in] unsigned long authSubType, [in] unsigned char[] data) | 设置口令数据，口令认证驱动处理注册或认证口令请求时，如果口令数据由口令认证服务获取，需要通过该接口将口令数据传给口令认证驱动。 | 24| [Enroll](#enroll) ([in] unsigned long scheduleId, [in] unsigned char[] extraInfo, [in] [IExecutorCallback](interface_i_executor_callback_pinauth_v10.md) callbackObj) | 注册口令。 | 25| [Authenticate](#authenticate) ([in] unsigned long scheduleId, [in] unsigned long templateId, [in] unsigned char[] extraInfo, [in] [IExecutorCallback](interface_i_executor_callback_pinauth_v10.md) callbackObj) | 认证口令。 | 26| [Delete](#delete) ([in] unsigned long templateId) | 删除口令。 | 27| [Cancel](#cancel) ([in] unsigned long scheduleId) | 取消操作请求。 | 28| [SendCommand](#sendcommand) ([in] int commandId, [in] unsigned char[] extraInfo, [in] [IExecutorCallback](interface_i_executor_callback_pinauth_v10.md) callbackObj) | 发送口令认证功能相关操作命令。 | 29 30 31## 成员函数说明 32 33 34### Authenticate() 35 36``` 37IExecutor::Authenticate ([in] unsigned long scheduleId, [in] unsigned long templateId, [in] unsigned char[] extraInfo, [in] IExecutorCallback callbackObj ) 38``` 39**描述** 40认证口令。 41 42**起始版本：** 3.2 43 44**参数:** 45 46| 名称 | 描述 | 47| -------- | -------- | 48| scheduleId | 调度ID，用于标识一次操作请求的调度过程。 | 49| templateId | 指定要认证的模版ID。 | 50| extraInfo | 其他相关信息，用于支持信息扩展。 | 51| callbackObj | 回调对象[IExecutorCallback](interface_i_executor_callback_pinauth_v10.md)。 | 52 53**返回：** 54 550 表示操作成功。 56 57非0 表示操作失败。 58 59 60### Cancel() 61 62``` 63IExecutor::Cancel ([in] unsigned long scheduleId) 64``` 65**描述** 66取消操作请求。 67 68**起始版本：** 3.2 69 70**参数:** 71 72| 名称 | 描述 | 73| -------- | -------- | 74| scheduleId | 调度ID，用于标识一次操作请求的调度过程。 | 75 76**返回：** 77 780 表示操作成功。 79 80非0 表示操作失败。 81 82 83### Delete() 84 85``` 86IExecutor::Delete ([in] unsigned long templateId) 87``` 88**描述** 89删除口令。 90 91**起始版本：** 3.2 92 93**参数:** 94 95| 名称 | 描述 | 96| -------- | -------- | 97| templateId | 模版ID。 | 98 99**返回：** 100 1010 表示操作成功。 102 103非0 表示操作失败。 104 105 106### Enroll() 107 108``` 109IExecutor::Enroll ([in] unsigned long scheduleId, [in] unsigned char[] extraInfo, [in] IExecutorCallback callbackObj ) 110``` 111**描述** 112注册口令。 113 114**起始版本：** 3.2 115 116**参数:** 117 118| 名称 | 描述 | 119| -------- | -------- | 120| scheduleId | 调度ID，用于标识一次操作请求的调度过程。 | 121| extraInfo | 其他相关信息，用于支持信息扩展。 | 122| callbackObj | 回调对象[IExecutorCallback](interface_i_executor_callback_pinauth_v10.md)。 | 123 124**返回：** 125 1260 表示操作成功。 127 128非0 表示操作失败。 129 130 131### GetExecutorInfo() 132 133``` 134IExecutor::GetExecutorInfo ([out] struct ExecutorInfo executorInfo) 135``` 136**描述** 137获取执行器信息，口令认证服务将执行器注册到用户认证框架时需要通过该接口获取对应信息。 138 139**起始版本：** 3.2 140 141**参数:** 142 143| 名称 | 描述 | 144| -------- | -------- | 145| executorInfo | 执行器信息[ExecutorInfo](_executor_info_pinauth_v10.md)。 | 146 147**返回：** 148 1490 表示操作成功。 150 151非0 表示操作失败。 152 153 154### GetTemplateInfo() 155 156``` 157IExecutor::GetTemplateInfo ([in] unsigned long templateId, [out] struct TemplateInfo templateInfo ) 158``` 159**描述** 160获取属性。 161 162**起始版本：** 3.2 163 164**参数:** 165 166| 名称 | 描述 | 167| -------- | -------- | 168| templateId | 凭据模版ID。 | 169| templateInfo | 凭据模版信息[TemplateInfo](_template_info_pinauth_v10.md)。 | 170 171**返回：** 172 1730 表示操作成功。 174 175非0 表示操作失败。 176 177 178### OnRegisterFinish() 179 180``` 181IExecutor::OnRegisterFinish ([in] unsigned long[] templateIdList, [in] unsigned char[] frameworkPublicKey, [in] unsigned char[] extraInfo ) 182``` 183**描述** 184完成执行器注册，对口令模版信息进行对账，用于删除无效的口令模板及相关信息。 185 186**起始版本：** 3.2 187 188**参数:** 189 190| 名称 | 描述 | 191| -------- | -------- | 192| templateIdList | 用户认证框架内由该执行器注册的口令凭据模版ID列表。 | 193| frameworkPublicKey | 用户认证框架的公钥，用于校验用户认证框架私钥签名的信息。 | 194| extraInfo | 其他相关信息，用于支持信息扩展。 | 195 196**返回：** 197 1980 表示操作成功。 199 200非0 表示操作失败。 201 202 203### OnSetData() 204 205``` 206IExecutor::OnSetData ([in] unsigned long scheduleId, [in] unsigned long authSubType, [in] unsigned char[] data ) 207``` 208**描述** 209设置口令数据，口令认证驱动处理注册或认证口令请求时，如果口令数据由口令认证服务获取，需要通过该接口将口令数据传给口令认证驱动。 210 211**起始版本：** 3.2 212 213**参数:** 214 215| 名称 | 描述 | 216| -------- | -------- | 217| scheduleId | 调度ID，用于标识一次操作请求的调度过程。 | 218| authSubType | 口令子类型，如六位数字PIN码等。 | 219| data | 口令数据。 | 220 221**返回：** 222 2230 表示操作成功。 224 225非0 表示操作失败。 226 227 228### SendCommand() 229 230``` 231IExecutor::SendCommand ([in] int commandId, [in] unsigned char[] extraInfo, [in] IExecutorCallback callbackObj ) 232``` 233**描述** 234发送口令认证功能相关操作命令。 235 236**起始版本：** 3.2 237 238**参数:** 239 240| 名称 | 描述 | 241| -------- | -------- | 242| commandId | 操作命令ID[CommandId](_hdf_pin_auth_v10.md#commandid)。 | 243| extraInfo | 其他相关信息，用于支持信息扩展。 | 244| callbackObj | 回调对象[IExecutorCallback](interface_i_executor_callback_pinauth_v10.md)。 | 245 246**返回：** 247 2480 表示操作成功。 249 250非0 表示操作失败。 251