DavGetExtendedError 函数 (davclnt.h)

检索 WebDAV 服务器为先前失败的 I/O 操作返回的扩展错误代码信息。

语法

DWORD DavGetExtendedError(
  [in]      HANDLE hFile,
  [out]     DWORD  *ExtError,
  [out]     LPWSTR ExtErrorString,
  [in, out] DWORD  *cChSize
);

[in] hFile

上一个 I/O 操作失败的打开文件的句柄。如果上一个操作是失败的创建操作，在这种情况下没有打开的文件句柄，请为此参数指定INVALID_HANDLE_VALUE。

[out] ExtError

指向接收扩展错误代码的变量的指针。

[out] ExtErrorString

指向以 null 结尾的 Unicode 字符串接收扩展错误信息的缓冲区的指针。

[in, out] cChSize

指向变量的指针，该变量在输入时指定 ExtErrorString 参数指向的缓冲区的大小（以 Unicode 字符为单位）。此值必须至少为 1024 个字符。

如果函数成功，则输出时变量将接收实际复制到缓冲区中的字符数。如果函数失败并出现ERROR_INSUFFICIENT_BUFFER，则变量接收 1024，但不会将字符复制到 ExtErrorString 缓冲区中。

如果函数成功，则返回值为 ERROR_SUCCESS。

如果函数失败，则返回值为系统错误代码，例如以下值之一。

返回代码	说明
ERROR_INVALID_PARAMETER	一个或多个参数值无效。
ERROR_INSUFFICIENT_BUFFER	cChSize 参数指向的值小于 1024。

如果为以前的 I/O 操作成功的文件句柄调用此函数，它将返回ERROR_INVALID_PARAMETER。