WNetSetLastErrorW 関数 (npapi.h)

拡張エラー情報を設定します。 ネットワーク プロバイダーは 、SetLastError の代わりにこの関数を呼び出す必要があります。

必要に応じて、 複数プロバイダー ルーター (MPR) は SetLastError を呼び出して、ネットワーク プロバイダーから返される Windows エラーを設定します。

構文

void WNetSetLastErrorW(
  [in] DWORD  err,
  [in] LPWSTR lpError,
  [in] LPWSTR lpProviders
);

パラメーター

[in] err

発生したエラー。 これはネットワーク固有のエラー コードです。

[in] lpError

ネットワーク固有のエラーを表す文字列。

[in] lpProviders

エラーを発生させたネットワーク プロバイダーの名前を示す文字列。

戻り値

なし

解説

この関数は Windows オペレーティング システムによって実装され、ネットワーク プロバイダーによって呼び出すことができます。

プロバイダーは、この関数を使用して、プロバイダー固有の情報を含むエラーを報告する必要があります。 エラー情報は、同じスレッド内の WNetSetLastError の別の呼び出しによって上書きされるまで保存されます。

プロバイダー関数が一般的なエラーを処理するための推奨される方法は、次のステートメントを使用することです。

return(providerError);

このステートメントでは、providerError は、このドキュメントのプロバイダー API に一覧表示されているリターン コードの 1 つなど、Windows エラー コードです。

プロバイダー固有のエラーの場合、プロバイダーは次の操作を行う必要があります。

//  Set up lpErrorString to be the error to be reported.
WNetSetLastError(providerError,
lpErrorString,
lpProviderName);
return(ERROR_EXTENDED_ERROR);

この場合、providerError はプロバイダー固有のエラー コードです。

プロバイダー関数から戻る前に、プロバイダーは SetLastError を呼び出す必要はありません。 MPR は SetLastError を呼び出して、アプリケーションを満たすために必要な場合にプロバイダーから返される Windows エラーを設定します。

要件