WNetGetLastErrorW 関数 (winnetwk.h)
WNetGetLastError 関数は、WNet 関数によって設定された最新の拡張エラー コードを取得します。 ネットワーク プロバイダーからこのエラー コードが報告されました。通常、SDK ヘッダー ファイル WinError.h に含まれるエラーの 1 つではありません。
構文
DWORD WNetGetLastErrorW(
[out] LPDWORD lpError,
[out] LPWSTR lpErrorBuf,
[in] DWORD nErrorBufSize,
[out] LPWSTR lpNameBuf,
[in] DWORD nNameBufSize
);
パラメーター
[out] lpError
ネットワーク プロバイダーによって報告されたエラー コードを受け取る変数へのポインター。 エラー コードは、ネットワーク プロバイダーに固有です。
[out] lpErrorBuf
エラーを記述する null で終わる文字列を受け取るバッファーへのポインター。
[in] nErrorBufSize
lpErrorBuf パラメーターが指すバッファーのサイズ (文字数)。 バッファーがエラー文字列に対して小さすぎる場合、文字列は切り捨てられますが、null で終わります。 256 文字以上のバッファーをお勧めします。
[out] lpNameBuf
エラーを発生させたネットワーク プロバイダーを識別する null で終わる文字列を受け取るバッファーへのポインター。
[in] nNameBufSize
lpNameBuf パラメーターが指すバッファーのサイズ (文字数)。 バッファーがエラー文字列に対して小さすぎる場合、文字列は切り捨てられますが、null で終わります。
戻り値
関数が成功し、ネットワーク プロバイダーによって報告された最後のエラーが取得された場合、戻り値はNO_ERROR。
呼び出し元が無効なバッファーを指定した場合、戻り値はERROR_INVALID_ADDRESS。
注釈
WNetGetLastError 関数は、ネットワーク プロバイダーに固有のエラーを取得します。 WNet 関数が ERROR_EXTENDED_ERRORを返すときに、 WNetGetLastError を呼び出すことができます。
GetLastError 関数と同様に、WNetGetLastError は、スレッドごとに維持される拡張エラー情報を返します。 GetLastError とは異なり、WNetGetLastError 関数は、WinError.h の既存のエラー コードで記述されていないエラーを報告するための文字列を返すことができます。
WNetGetLastError 関数を呼び出すアプリケーション定義エラー ハンドラーの使用の詳細については、「ネットワーク エラーの取得」を参照してください。
注意
winnetwk.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして WNetGetLastError を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winnetwk.h |
| Library | Mpr.lib |
| [DLL] | Mpr.dll |