Freigeben über


DavFlushFile-Funktion (davclnt.h)

Leert die Daten aus der lokalen Version einer Remotedatei auf den WebDAV-Server.

Syntax

DWORD DavFlushFile(
  [in] HANDLE hFile
);

Parameter

[in] hFile

Ein Handle für eine geöffnete Datei auf einem WebDAV-Server.

Das Dateihandle muss über das zugriffsrecht GENERIC_WRITE verfügen. Weitere Informationen finden Sie unter Dateisicherheit und Zugriffsrechte.

Rückgabewert

Wenn die Funktion erfolgreich ist oder hFile ein Handle für eine verschlüsselte Datei ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode.

Hinweise

Wenn eine Anwendung eine Remotedatei auf einem WebDAV-Server erstellt oder öffnet, lädt der WebDAV-Dienst die Datei auf den lokalen Computer herunter, und die Anwendung empfängt ein Handle für die geöffnete Datei auf dem Server. Alle Änderungen, die die Anwendung an der lokalen Datei vornimmt, haben keine Auswirkungen auf die Remotedatei, bis das Dateihandle geschlossen und die lokale Version der Datei auf den Server hochgeladen wird. Da das Dateihandle gleichzeitig mit dem Speichern der Datei auf dem Server geschlossen wird, kann die Anwendung nicht überprüfen, ob die Datei erfolgreich gespeichert wurde.

Um dieses Problem zu vermeiden, verwenden Sie die DavFlushFile-Funktion , um die Daten aus der lokalen Version der Datei in die Remotedatei auf dem WebDAV-Server zu leeren. Wenn die Funktion erfolgreich ist, bedeutet dies, dass die Datei erfolgreich gespeichert wurde.

Mit dieser Funktion werden verschlüsselte Dateien nicht geleert. Wenn hFile ein Handle für eine verschlüsselte Datei ist, gibt DavFlushFile ERROR_SUCCESS zurück, ohne die Dateidaten zu leeren.

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

Weitere Informationen

CreateFile

FlushFileBuffers

OpenFile

WriteFile