Compartir a través de

WS_GET_CERT_CALLBACK función de devolución de llamada (webservices.h)

  • Artículo

Proporciona un certificado al entorno de ejecución de seguridad. Esta devolución de llamada se especifica como parte del WS_CUSTOM_CERT_CREDENTIAL, que a su vez se puede especificar como parte de un enlace de seguridad que requiere una credencial de certificado. El tiempo de ejecución invocará esta devolución de llamada cuando se abra el canal (lado cliente) o el agente de escucha (lado servidor).

Propiedad del certificado: si esta devolución de llamada devuelve un HRESULT correcto, el autor de la llamada (es decir, el entorno de ejecución de seguridad) tomará posesión del certificado devuelto y lo liberará cuando el canal contenedor ya no lo necesite. Si esta devolución de llamada devuelve un error HRESULT, el autor de la llamada NO tomará posesión de , o incluso observará, el valor devuelto en el parámetro out 'cert'.

Sintaxis

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
)
{...}

Parámetros

[in] getCertCallbackState

Estado que se especificó junto con esta devolución de llamada en la credencial del certificado.

[in, optional] targetAddress

La dirección de destino a la que se va a presentar este certificado, en caso de que se especifique esta credencial de certificado para un cliente.

[in, optional] viaUri

Dirección a la que se va a presentar este certificado.

cert

Ubicación que se va a devolver el certificado.

[in, optional] error

Especifica dónde se debe almacenar información de error adicional si se produce un error en la función.

Valor devuelto

Esta función de devolución de llamada no devuelve un valor.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado webservices.h