WNetGetNetworkInformationA 関数 (winnetwk.h)

WNetGetNetworkInformation 関数は、以前のネットワーク列挙によって名前が返された特定のネットワーク プロバイダーに関する拡張情報を返します。

構文

DWORD WNetGetNetworkInformationA(
  [in]  LPCSTR          lpProvider,
  [out] LPNETINFOSTRUCT lpNetInfoStruct
);

パラメーター

[in] lpProvider

情報が必要なネットワーク プロバイダーの名前を含む、null で終わる定数文字列へのポインター。

[out] lpNetInfoStruct

NETINFOSTRUCT 構造体へのポインター。 構造体は、ネットワークの特性を記述します。

戻り値

関数が成功した場合、戻り値はNO_ERROR。

関数が失敗した場合、戻り値は システム エラー コード (次のいずれかの値など) です。

リターン コード 説明
ERROR_BAD_PROVIDER
lpProvider パラメーターは、実行中のネットワーク プロバイダーと一致しません。
ERROR_BAD_VALUE
NETINFOSTRUCT 構造体の cbStructure メンバーに、有効な構造体サイズが含まれていません。

解説

注意

winnetwk.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして WNetGetNetworkInformation を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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

関連項目

NETINFOSTRUCT

NETRESOURCE

WNetEnumResource

WNetGetProviderName

WNetOpenEnum

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

Windows ネットワーク関数