WS_GET_CERT_CALLBACK função de retorno de chamada (webservices.h)

Fornece um certificado para o runtime de segurança. Esse retorno de chamada é especificado como parte da WS_CUSTOM_CERT_CREDENTIAL, que por sua vez pode ser especificada como parte de uma associação de segurança que requer uma credencial de certificado. O runtime invocará esse retorno de chamada quando o canal (lado do cliente) ou o ouvinte (lado do servidor) for aberto.

Propriedade do certificado: se esse retorno de chamada retornar um HRESULT bem-sucedido, o chamador (ou seja, o runtime de segurança) assumirá a propriedade do certificado retornado e o liberará quando o canal independente não precisar mais dele. Se esse retorno de chamada retornar um HRESULT de falha, o chamador NÃO assumirá a propriedade ou até mesmo examinará o valor retornado no parâmetro out 'cert'.

Sintaxe

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 foi especificado junto com esse retorno de chamada na credencial de certificado.

[in, optional] targetAddress

O endereço de destino ao qual esse certificado deve ser apresentado, caso essa credencial de certificado seja especificada para um cliente.

[in, optional] viaUri

O por meio do endereço a quem este certificado deve ser apresentado.

cert

O local para retornar o certificado.

[in, optional] error

Especifica onde informações adicionais de erro devem ser armazenadas se a função falhar.

Retornar valor

Essa função de retorno de chamada não retorna um valor.

Requisitos