WNetGetLastErrorA 関数 (winnetwk.h)

  • [アーティクル]

WNetGetLastError 関数は、WNet 関数によって設定された最新の拡張エラー コードを取得します。 ネットワーク プロバイダーからこのエラー コードが報告されました。一般に、SDK ヘッダー ファイル WinError.h に含まれるエラーの 1 つではありません。

構文

DWORD WNetGetLastErrorA(
  [out] LPDWORD lpError,
  [out] LPSTR   lpErrorBuf,
  [in]  DWORD   nErrorBufSize,
  [out] LPSTR   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 を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winnetwk.h
Library Mpr.lib
[DLL] Mpr.dll

こちらもご覧ください

Windows ネットワーク (WNet) の概要

Windows ネットワーク関数