Share via

NETINFOSTRUCT 構造体 (winnetwk.h)

  • [アーティクル]

NETINFOSTRUCT 構造体には、WNetGetNetworkInformation 関数によって返されるネットワーク プロバイダーを記述する情報が含まれています。

構文

typedef struct _NETINFOSTRUCT {
  DWORD     cbStructure;
  DWORD     dwProviderVersion;
  DWORD     dwStatus;
  DWORD     dwCharacteristics;
  ULONG_PTR dwHandle;
  WORD      wNetType;
  DWORD     dwPrinters;
  DWORD     dwDrives;
} NETINFOSTRUCT, *LPNETINFOSTRUCT;

メンバー

cbStructure

型: DWORD

NETINFOSTRUCT 構造体のサイズ (バイト単位)。 呼び出し元は、渡された構造体のサイズを示すために、この値を指定する必要があります。 戻ると、構造体のサイズが入力されます。

dwProviderVersion

型: DWORD

ネットワーク プロバイダー ソフトウェアのバージョン番号。

dwStatus

型: DWORD

ネットワーク プロバイダー ソフトウェアの現在の状態。 このメンバーには、次のいずれかの値を指定できます。

値 意味
NO_ERROR
 ネットワークが実行されています。
ERROR_NO_NETWORK
 ネットワークが利用できません。
ERROR_BUSY
 現在、ネットワークは要求をサービスできませんが、すぐに使用できるようになります。 (通常、この値はネットワークが起動していることを示します)。

dwCharacteristics

型: DWORD

ネットワーク プロバイダー ソフトウェアの特性。

この値は 0 です。

Windows Me/98/95: このメンバーには、次の値の 1 つ以上を指定できます。

値 意味
NETINFO_DLL16
 ネットワーク プロバイダーは、16 ビットの Windows ネットワーク ドライバーとして実行されています。
NETINFO_DISKRED
 ネットワーク プロバイダーは、サーバー ファイル システムにアクセスするために、リダイレクトされたローカル ディスク ドライブ デバイスを必要とします。
NETINFO_PRINTERRED
 ネットワーク プロバイダーは、サーバー ファイル システムにアクセスするために、リダイレクトされたローカル プリンター ポートを必要とします。

dwHandle

種類: ULONG_PTR

ネットワーク プロバイダーまたは 16 ビット Windows ネットワーク ドライバーのインスタンス ハンドル。

wNetType

種類: WORD

実行中のネットワークに固有のネットワークの種類。 この値は、リソースが永続的またはリンクに格納されている場合に、リソースを特定のネットワークに関連付けます。 ネットワークの種類の完全な一覧は、ヘッダー ファイル Winnetwk.h にあります。

dwPrinters

型: DWORD

LPT1 に対応する下位ビットを使用して、ローカル プリンター デバイスをリダイレクトするための有効な印刷番号を示すビット フラグのセット。

Windows Me/98/95: この値は常に –1 に設定されます。

dwDrives

型: DWORD

A: に対応する下位ビットを使用して、ディスク ドライブをリダイレクトするための有効なローカル ディスク デバイスを示すビット フラグのセット。

Windows Me/98/95: この値は常に –1 に設定されます。

注釈

NETINFOSTRUCT 構造体には、ネットワーク プロバイダー ソフトウェアのバージョンやネットワークの現在の状態など、ネットワークを記述する情報が含まれています。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header winnetwk.h

こちらもご覧ください

WNetGetNetworkInformation

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

Windows ネットワーク構造