Funzione di callback PFNDAVAUTHCALLBACK (davclnt.h)
Il client WebDAV chiama la funzione di callback davAuthCallback definita dall'applicazione per richiedere all'utente le credenziali.
Il tipo PFNDAVAUTHCALLBACK definisce un puntatore a questa funzione di callback. DavAuthCallback è un segnaposto per il nome della funzione definita dall'applicazione.
Sintassi
PFNDAVAUTHCALLBACK Pfndavauthcallback;
DWORD Pfndavauthcallback(
[in] LPWSTR lpwzServerName,
[in] LPWSTR lpwzRemoteName,
[in] DWORD dwAuthScheme,
[in] DWORD dwFlags,
[in, out] PDAV_CALLBACK_CRED pCallbackCred,
[in, out] AUTHNEXTSTEP *NextStep,
[out] PFNDAVAUTHCALLBACK_FREECRED *pFreeCred
)
{...}
Parametri
[in] lpwzServerName
Puntatore a una stringa Unicode con terminazione NULL contenente il nome del server di destinazione.
[in] lpwzRemoteName
Puntatore a una stringa Unicode con terminazione NULL contenente il nome della risorsa di rete.
[in] dwAuthScheme
Maschera di flag che specificano gli schemi di autenticazione da usare.
| Valore | Significato |
|---|---|
|
L'autenticazione di base deve essere usata. |
|
L'autenticazione di Microsoft NTLM deve essere usata. |
|
L'autenticazione passport deve essere usata. |
|
L'autenticazione di Microsoft Digest deve essere usata. |
|
Microsoft Negotiate deve essere usato. |
|
L'autenticazione del certificato deve essere usata. |
|
L'autenticazione basata su moduli deve essere usata. |
[in] dwFlags
Flag passati al servizio WebDAV nel parametro dwFlags quando ha chiamato la funzione NPAddConnection3 .
[in, out] pCallbackCred
Puntatore a una struttura DAV_CALLBACK_CRED .
[in, out] NextStep
Puntatore a un valore di enumerazione AUTHNEXTSTEP che specifica l'azione successiva che il client WebDAV deve eseguire dopo una chiamata riuscita alla funzione di callback DavAuthCallback .
[out] pFreeCred
Puntatore a una funzione di callback DavFreeCredCallback .
Valore restituito
Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema.
Commenti
La funzione di callback DavAuthCallback deve essere registrata chiamando la funzione DavRegisterAuthCallback .
Per annullare la registrazione di questa funzione di callback, usare la funzione DavUnregisterAuthCallback .
Questa funzione di callback deve richiedere all'utente le credenziali ( un nome utente e una password o un BLOB di autenticazione) e archiviare queste informazioni nel membro appropriato della struttura DAV_CALLBACK_CRED a cui punta il parametro pCallbackCred .
Requisiti
| Client minimo supportato | Windows Vista con SP2 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 con SP2 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | davclnt.h |