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 |