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

Valida um par de nome de usuário/senha no lado do receptor. Quando um WS_USERNAME_MESSAGE_SECURITY_BINDING que contém esse retorno de chamada é incluído na descrição de segurança, esse retorno de chamada é invocado para cada mensagem recebida no servidor. Espera-se que esse retorno de chamada retorne S_OKif o par nome de usuário/senha foi validado com êxito, S_FALSE quando o par não pôde ser validado 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 canal/ouvinte aberto e fechado, mas nunca será invocado quando um canal não estiver aberto. Na queda atual, esse retorno de chamada é sempre invocado de forma síncrona. Na próxima queda, esse retorno de chamada será invocado de forma síncrona para recebimentos de mensagens síncronas e de forma assíncrona para recebimentos de mensagens assíncronas, mas sempre será invocado de forma abreviada quando for invocada de forma assíncrona.

Sintaxe

WS_VALIDATE_PASSWORD_CALLBACK WsValidatePasswordCallback;

HRESULT WsValidatePasswordCallback(
  [in, optional] void *passwordValidatorCallbackState,
  [in]           const WS_STRING *username,
  [in]           const WS_STRING *password,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR *error
)
{...}

Parâmetros

[in, optional] passwordValidatorCallbackState

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

[in] username

Nome de usuário recebido.

[in] password

Senha recebida.

[in, optional] asyncContext

Informações sobre como invocar a função de forma assíncrona ou NULL se estiver invocando de forma síncrona.

[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