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。

如果函式失敗，傳回值是系統錯誤碼，例如下列其中一個值。

傳回碼	Description
ERROR_INVALID_PARAMETER	一或多個參數值無效。
ERROR_INSUFFICIENT_BUFFER	cChSize 參數指向的值小於 1024。

如果您針對先前 I/O 作業成功的檔句柄呼叫此函式，它會傳回ERROR_INVALID_PARAMETER。