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

Valida uma declaração SAML. Se uma asserção SAML recebida passar nas verificações de assinatura que garantem que o SAML foi emitido por um emissor confiável, esse retorno de chamada será invocado para permitir que o aplicativo faça validação adicional no formulário XML da declaração SAML. Espera-se que esse retorno de chamada retorne S_OK se a declaração SAML foi validada com êxito, S_FALSE quando a declaração não pôde ser validada e um valor de erro se ocorreu um erro inesperado. Retornar qualquer resultado diferente de S_OK desse retorno de chamada resultará na falha da mensagem de recebimento associada com um erro de segurança.

Assim como acontece com todos os retornos de chamada de segurança, o aplicativo deve esperar receber esse retorno de chamada a qualquer momento entre o ouvinte aberto e fechado, mas nunca será invocado quando um ouvinte não estiver aberto.

Sintaxe

WS_VALIDATE_SAML_CALLBACK WsValidateSamlCallback;

HRESULT WsValidateSamlCallback(
  [in, optional] void *samlValidatorCallbackState,
  [in]           WS_XML_BUFFER *samlAssertion,
  [in, optional] WS_ERROR *error
)
{...}

Parâmetros

[in, optional] samlValidatorCallbackState

O estado a ser passado de volta ao invocar esse retorno de chamada.

[in] samlAssertion

A declaração SAML recebida que passou por uma assinatura bem-sucedida marcar.

[in, optional] error

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

Valor retornado

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

Requisitos