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