PFNDAVAUTHCALLBACK-Rückruffunktion (davclnt.h)
Der WebDAV-Client ruft die anwendungsdefinierte DavAuthCallback-Rückruffunktion auf, um den Benutzer zur Eingabe von Anmeldeinformationen aufzufordern.
Der PFNDAVAUTHCALLBACK-Typ definiert einen Zeiger auf diese Rückruffunktion. DavAuthCallback ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.
Syntax
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
)
{...}
Parameter
[in] lpwzServerName
Ein Zeiger auf eine MIT NULL endende Unicode-Zeichenfolge, die den Namen des Zielservers enthält.
[in] lpwzRemoteName
Ein Zeiger auf eine MIT NULL endende Unicode-Zeichenfolge, die den Namen der Netzwerkressource enthält.
[in] dwAuthScheme
Eine Bitmaske von Flags, die die zu verwendenden Authentifizierungsschemas angeben.
| Wert | Bedeutung |
|---|---|
|
Die Standardauthentifizierung muss verwendet werden. |
|
Die Microsoft NTLM-Authentifizierung ist zu verwenden. |
|
Die Passport-Authentifizierung muss verwendet werden. |
|
Die Microsoft Digest-Authentifizierung muss verwendet werden. |
|
Microsoft Negotiate soll verwendet werden. |
|
Die Zertifikatauthentifizierung muss verwendet werden. |
|
Die formularbasierte Authentifizierung soll verwendet werden. |
[in] dwFlags
Die Flags, die der WebDAV-Dienst im dwFlags-Parameter übergeben hat , als er die FUNKTION NPAddConnection3 aufgerufen hat.
[in, out] pCallbackCred
Ein Zeiger auf eine DAV_CALLBACK_CRED-Struktur .
[in, out] NextStep
Ein Zeiger auf einen AUTHNEXTSTEP-Enumerationswert , der die nächste Aktion angibt, die der WebDAV-Client nach einem erfolgreichen Aufruf der DavAuthCallback-Rückruffunktion ausführen soll.
[out] pFreeCred
Ein Zeiger auf eine DavFreeCredCallback-Rückruffunktion .
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode.
Hinweise
Die DavAuthCallback-Rückruffunktion muss durch Aufrufen der Funktion DavRegisterAuthCallback registriert werden.
Um die Registrierung dieser Rückruffunktion aufzuheben, verwenden Sie die Funktion DavUnregisterAuthCallback .
Diese Rückruffunktion sollte den Benutzer zur Eingabe von Anmeldeinformationen (entweder einen Benutzernamen und ein Kennwort oder ein Authentifizierungsblob) auffordern und diese Informationen im entsprechenden Member der DAV_CALLBACK_CRED Struktur speichern, auf die der pCallbackCred-Parameter verweist.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 mit SP2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | davclnt.h |