次の方法で共有

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 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー winnetwk.h
ライブラリ Mpr.lib
DLL Mpr.dll

関連項目

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

Windows ネットワーク機能の