Функция DavFlushFile (davclnt.h)

Статья
08/23/2023

Сбрасывает данные из локальной версии удаленного файла на сервер WebDAV.

Синтаксис

DWORD DavFlushFile(
  [in] HANDLE hFile
);

Параметры

[in] hFile

Дескриптор открытого файла на сервере WebDAV.

Дескриптор файла должен иметь право доступа к GENERIC_WRITE. Дополнительные сведения см. в разделе Безопасность файлов и права доступа.

Возвращаемое значение

Если функция выполнена успешно или если hFile является дескриптором зашифрованного файла, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается сбоем, возвращаемое значение представляет собой системный код ошибки.

Когда приложение создает или открывает удаленный файл на сервере WebDAV, служба WebDAV скачивает файл на локальный компьютер, и приложение получает дескриптор открытого файла на сервере. Любые изменения, внесенные приложением в локальный файл, не влияют на удаленный файл, пока дескриптор файла не будет закрыт и локальная версия файла не будет отправлена на сервер. Так как дескриптор файла закрывается одновременно с сохранением файла на сервере, приложение не может проверка, был ли файл успешно сохранен.

Чтобы избежать этой проблемы, используйте функцию DavFlushFile для очистки данных из локальной версии файла в удаленный файл на сервере WebDAV. Если функция выполнена успешно, это означает, что файл успешно сохранен.

Эта функция не очищает зашифрованные файлы. Если hFile является дескриптором зашифрованного файла, DavFlushFile возвращает ERROR_SUCCESS без очистки данных файла.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	davclnt.h
Библиотека	Netapi32.lib
DLL	Netapi32.dll

См. также раздел

Share via