Compartir a través de

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

  • Artículo

Valida un par de nombre de usuario y contraseña en el lado receptor. Cuando se incluye un WS_USERNAME_MESSAGE_SECURITY_BINDING que contiene esta devolución de llamada en la descripción de seguridad, esta devolución de llamada se invoca para cada mensaje recibido en el servidor. Se espera que esta devolución de llamada devuelva S_OKif se validó correctamente el par nombre de usuario y contraseña, S_FALSE cuando no se pudo validar el par y un valor de error si se produjo un error inesperado. Devolver cualquier resultado distinto de S_OK de esta devolución de llamada producirá un error de seguridad en el mensaje de recepción asociado.

Al igual que con todas las devoluciones de llamada de seguridad, la aplicación debe esperar recibir esta devolución de llamada en cualquier momento entre el canal o el agente de escucha abiertos y cerrados, pero nunca se invocará cuando un canal no esté abierto. En la lista desplegable actual, esta devolución de llamada siempre se invoca de forma sincrónica. En la lista desplegable siguiente, esta devolución de llamada se invocará de forma sincrónica para recibir y de forma asincrónica los mensajes asincrónicos, pero siempre se invocará brevemente cuando se invoque de forma asincrónica.

Sintaxis

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

Estado que se va a devolver al invocar esta devolución de llamada.

[in] username

Nombre de usuario recibido.

[in] password

Contraseña recibida.

[in, optional] asyncContext

Información sobre cómo invocar la función de forma asincrónica o NULL si invoca de forma sincrónica.

[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