DavGetExtendedError-Funktion (davclnt.h)
Ruft die erweiterten Fehlercodeinformationen ab, die der WebDAV-Server für den vorherigen fehlgeschlagenen E/A-Vorgang zurückgegeben hat.
Syntax
DWORD DavGetExtendedError(
[in] HANDLE hFile,
[out] DWORD *ExtError,
[out] LPWSTR ExtErrorString,
[in, out] DWORD *cChSize
);
Parameter
[in] hFile
Ein Handle für eine geöffnete Datei, für die beim vorherigen E/A-Vorgang ein Fehler aufgetreten ist. Wenn der vorherige Vorgang ein Fehler beim Erstellen ist und in diesem Fall kein geöffnetes Dateihandle vorhanden ist, geben Sie INVALID_HANDLE_VALUE für diesen Parameter an.
[out] ExtError
Zeiger auf eine Variable, die den erweiterten Fehlercode empfängt.
[out] ExtErrorString
Zeiger auf einen Puffer, der die erweiterten Fehlerinformationen als unicode-Zeichenfolge mit NULL-Beendigung empfängt.
[in, out] cChSize
Ein Zeiger auf eine Variable, die bei der Eingabe die Größe des Puffers in Unicode-Zeichen angibt, auf den der ExtErrorString-Parameter verweist. Dieser Wert muss mindestens 1024 Zeichen lang sein.
Wenn die Funktion erfolgreich ist, empfängt die Variable bei der Ausgabe die Anzahl der Zeichen, die tatsächlich in den Puffer kopiert werden. Wenn die Funktion mit ERROR_INSUFFICIENT_BUFFER fehlschlägt, empfängt die Variable 1024, aber es werden keine Zeichen in den ExtErrorString-Puffer kopiert.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode, z. B. einer der folgenden Werte.
| Rückgabecode | Beschreibung |
|---|---|
|
Mindestens ein Parameterwert war ungültig. |
|
Der Wert, auf den der cChSize-Parameter verweist, war kleiner als 1024. |
Hinweise
Wenn Sie diese Funktion für ein Dateihandle aufrufen, dessen vorheriger E/A-Vorgang erfolgreich war, wird ERROR_INVALID_PARAMETER zurückgegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | davclnt.h |
| Bibliothek | Netapi32.lib |
| DLL | Netapi32.dll |