WS_GET_CERT_CALLBACK回调函数 (webservices.h)
向安全运行时提供证书。 此回调指定为 WS_CUSTOM_CERT_CREDENTIAL的一部分,后者又可以指定为需要证书凭据的安全绑定的一部分。 当通道 (客户端) 或侦听器 (服务器端) 打开时,运行时将调用此回调。
证书所有权:如果此回调返回成功 HRESULT,则调用方 (即安全运行时) 将获取返回证书的所有权,并在包含的通道不再需要证书时释放它。 如果此回调返回失败 HRESULT,则调用方将不获取输出参数“cert”中返回的值的所有权,甚至不会查看该值。
语法
WS_GET_CERT_CALLBACK WsGetCertCallback;
HRESULT WsGetCertCallback(
[in] void *getCertCallbackState,
[in, optional] const WS_ENDPOINT_ADDRESS *targetAddress,
[in, optional] const WS_STRING *viaUri,
const _CERT_CONTEXT **cert,
[in, optional] WS_ERROR *error
)
{...}
参数
[in] getCertCallbackState
在证书凭据中随此回调一起指定的状态。
[in, optional] targetAddress
要向其出示此证书的目标地址,以防为客户端指定此证书凭据。
[in, optional] viaUri
要向其出示此证书的通过地址。
cert
要返回证书的位置。
[in, optional] error
指定在函数失败时应存储其他错误信息的位置。
返回值
此回调函数不返回值。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | webservices.h |