WS_VALIDATE_PASSWORD_CALLBACK fonction de rappel (webservices.h)

  • Article

Valide une paire nom d’utilisateur/mot de passe côté récepteur. Lorsqu’un WS_USERNAME_MESSAGE_SECURITY_BINDING contenant ce rappel est inclus dans la description de sécurité, ce rappel est appelé pour chaque message reçu sur le serveur. Ce rappel est censé retourner S_OKif la paire nom d’utilisateur/mot de passe a été correctement validée, S_FALSE lorsque la paire n’a pas pu être validée et une valeur d’erreur si une erreur inattendue s’est produite. Le renvoi d’un résultat autre que S_OK à partir de ce rappel entraîne l’échec du message de réception associé avec une erreur de sécurité.

Comme pour tous les rappels de sécurité, l’application doit s’attendre à recevoir ce rappel à tout moment entre l’ouverture et la fermeture du canal/de l’écouteur, mais il ne sera jamais appelé lorsqu’un canal n’est pas ouvert. Dans la suppression actuelle, ce rappel est toujours appelé de manière synchrone. Dans la suppression suivante, ce rappel sera appelé de manière synchrone pour les réceptions de messages synchrones et de manière asynchrone pour les réceptions de messages asynchrones, mais il sera toujours appelé de manière courte lorsqu’il est appelé de manière asynchrone.

Syntaxe

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

Paramètres

[in, optional] passwordValidatorCallbackState

État à renvoyer lors de l’appel de ce rappel.

[in] username

Nom d’utilisateur reçu.

[in] password

Mot de passe reçu.

[in, optional] asyncContext

Informations sur l’appel de la fonction de manière asynchrone ou NULL si l’appel est synchrone.

[in, optional] error

Spécifie l’emplacement où les informations d’erreur supplémentaires doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Cette fonction de rappel ne retourne pas de valeur.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête webservices.h