WS_VALIDATE_PASSWORD_CALLBACK funzione di callback (webservices.h)

Convalida una coppia nome utente/password sul lato ricevitore. Quando un WS_USERNAME_MESSAGE_SECURITY_BINDING contenente questo callback è incluso nella descrizione della sicurezza, questo callback viene richiamato per ogni messaggio ricevuto nel server. Questo callback dovrebbe restituire S_OKif la coppia nome utente/password è stata convalidata correttamente, S_FALSE quando la coppia non è stata convalidata e un valore di errore se si è verificato un errore imprevisto. Se si restituisce un risultato diverso da S_OK da questo callback, il messaggio di ricezione associato ha esito negativo con un errore di sicurezza.

Come per tutti i callback di sicurezza, l'applicazione dovrebbe aspettarsi di ricevere questo callback qualsiasi volta tra canale/listener aperto e chiuso, ma non verrà mai richiamato quando un canale non è aperto. Nell'elenco a discesa corrente, questo callback viene sempre richiamato in modo sincrono. Nell'elenco a discesa successivo questo callback verrà richiamato in modo sincrono per ricevere messaggi sincroni e in modo asincrono per ricevere messaggi asincroni, ma verrà sempre richiamato in breve quando viene richiamato in modo asincrono.

Sintassi

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

Parametri

[in, optional] passwordValidatorCallbackState

Stato da passare di nuovo quando si richiama questo callback.

[in] username

Nome utente ricevuto.

[in] password

Password ricevuta.

[in, optional] asyncContext

Informazioni su come richiamare la funzione in modo asincrono o NULL se si richiama in modo sincrono.

[in, optional] error

Specifica la posizione in cui devono essere archiviate informazioni aggiuntive sugli errori se la funzione ha esito negativo.

Valore restituito

Questa funzione di callback non restituisce un valore.

Requisiti