Fonction de rappel PFNDAVAUTHCALLBACK (davclnt.h)
Le client WebDAV appelle la fonction de rappel DavAuthCallback définie par l’application pour inviter l’utilisateur à entrer des informations d’identification.
Le type PFNDAVAUTHCALLBACK définit un pointeur vers cette fonction de rappel. DavAuthCallback est un espace réservé pour le nom de fonction défini par l’application.
Syntaxe
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
)
{...}
Paramètres
[in] lpwzServerName
Pointeur vers une chaîne Unicode terminée par NULL qui contient le nom du serveur cible.
[in] lpwzRemoteName
Pointeur vers une chaîne Unicode terminée par null qui contient le nom de la ressource réseau.
[in] dwAuthScheme
Masque de bits d’indicateurs qui spécifient les schémas d’authentification à utiliser.
| Valeur | Signification |
|---|---|
|
L’authentification de base doit être utilisée. |
|
L’authentification Microsoft NTLM doit être utilisée. |
|
L’authentification passport doit être utilisée. |
|
L’authentification Microsoft Digest doit être utilisée. |
|
Microsoft Negotiate doit être utilisé. |
|
L’authentification par certificat doit être utilisée. |
|
L’authentification basée sur les formulaires doit être utilisée. |
[in] dwFlags
Indicateurs que le service WebDAV a transmis dans le paramètre dwFlags quand il a appelé la fonction NPAddConnection3 .
[in, out] pCallbackCred
Pointeur vers une structure DAV_CALLBACK_CRED .
[in, out] NextStep
Pointeur vers une valeur d’énumération AUTHNEXTSTEP qui spécifie l’action suivante que le client WebDAV doit effectuer après un appel réussi à la fonction de rappel DavAuthCallback .
[out] pFreeCred
Pointeur vers une fonction de rappel DavFreeCredCallback .
Valeur retournée
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour est un code d’erreur système.
Notes
La fonction de rappel DavAuthCallback doit être inscrite en appelant la fonction DavRegisterAuthCallback .
Pour annuler l’inscription de cette fonction de rappel, utilisez la fonction DavUnregisterAuthCallback .
Cette fonction de rappel doit inviter l’utilisateur à entrer des informations d’identification ( un nom d’utilisateur et un mot de passe ou un objet BLOB d’authentification) et stocker ces informations dans le membre approprié de la structure DAV_CALLBACK_CRED vers laquelle pointe le paramètre pCallbackCred .
Spécifications
| Client minimal pris en charge | Windows Vista avec SP2 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 avec SP2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | davclnt.h |