WS_VALIDATE_PASSWORD_CALLBACK Rückruffunktion (webservices.h)

Artikel
08/27/2023

Überprüft ein Benutzername/Kennwort-Paar auf der Empfängerseite. Wenn in der Sicherheitsbeschreibung ein WS_USERNAME_MESSAGE_SECURITY_BINDING mit diesem Rückruf enthalten ist, wird dieser Rückruf für jede empfangene Nachricht auf dem Server aufgerufen. Dieser Rückruf wird erwartet, S_OKif das Benutzername-Kennwort-Paar erfolgreich überprüft wurde, S_FALSE, wenn das Paar nicht überprüft werden konnte, und einen Fehlerwert zurückgibt, wenn ein unerwarteter Fehler aufgetreten ist. Das Zurückgeben eines anderen Ergebnisses als S_OK aus diesem Rückruf führt dazu, dass die zugeordnete Empfangsnachricht mit einem Sicherheitsfehler fehlschlägt.

Wie bei allen Sicherheitsrückrufen sollte die Anwendung erwarten, dass dieser Rückruf jederzeit zwischen dem Öffnen und Schließen des Kanals/Listeners empfangen wird, aber er wird nie aufgerufen, wenn ein Kanal nicht geöffnet ist. Im aktuellen Drop wird dieser Rückruf immer synchron aufgerufen. Im nächsten Drop wird dieser Rückruf synchron für synchrone Nachrichten empfängt und asynchron für asynchrone Nachrichten empfängt, aber er wird immer kurz aufgerufen, wenn er asynchron aufgerufen wird.

Syntax

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

Parameter

[in, optional] passwordValidatorCallbackState

Der Zustand, der beim Aufrufen dieses Rückrufs zurückgegeben werden soll.

[in] username

Benutzername erhalten.

[in] password

Kennwort erhalten.

[in, optional] asyncContext

Informationen zum asynchronen Aufrufen der Funktion oder NULL beim synchronen Aufrufen.

[in, optional] error

Gibt an, wo zusätzliche Fehlerinformationen gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Rückruffunktion gibt keinen Wert zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	webservices.h

Share via