DavFlushFile 函数 (davclnt.h)

  • 项目

将数据从远程文件的本地版本刷新到 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
标头 davclnt.h
Library Netapi32.lib
DLL Netapi32.dll

另请参阅

CreateFile

FlushFileBuffers

OpenFile

WriteFile