DavGetExtendedError 関数 (davclnt.h)

以前に失敗した I/O 操作に対して WebDAV サーバーから返された拡張エラーコード情報を取得します。

構文

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	1 つ以上のパラメーター値が無効でした。
ERROR_INSUFFICIENT_BUFFER	cChSize パラメーターが指す値が 1024 未満でした。

以前の I/O 操作が成功したファイルハンドルに対してこの関数を呼び出すと、ERROR_INVALID_PARAMETERが返されます。