IP_INTERFACE_NAME_INFO_W2KSP1 構造体 (iptypes.h)

  • [アーティクル]

IP_INTERFACE_NAME_INFO構造体には、ローカル コンピューター上の IPv4 インターフェイスに関する情報が含まれています。

構文

typedef struct ip_interface_name_info_w2ksp1 {
  ULONG Index;
  ULONG MediaType;
  UCHAR ConnectionType;
  UCHAR AccessType;
  GUID  DeviceGuid;
  GUID  InterfaceGuid;
} IP_INTERFACE_NAME_INFO_W2KSP1, *PIP_INTERFACE_NAME_INFO_W2KSP1;

メンバー

Index

種類: ULONG

アクティブなインスタンスの IP インターフェイスのインデックス。

MediaType

種類: ULONG

インターネット割り当て名機関 (IANA) で定義されているインターフェイス型。 インターフェイスの種類に使用できる値は、Ipifcons.h ヘッダー ファイルに一覧表示されます。

次の表に、インターフェイス型の一般的な値を示します。ただし、他の多くの値が可能です。

値 意味
IF_TYPE_OTHER
1
 その他の種類のネットワーク インターフェイス。
IF_TYPE_ETHERNET_CSMACD
6
 イーサネット ネットワーク インターフェイス。
IF_TYPE_ISO88025_TOKENRING
9
 トークン リング ネットワーク インターフェイス。
IF_TYPE_PPP
23
 PPP ネットワーク インターフェイス。
IF_TYPE_SOFTWARE_LOOPBACK
24
 ソフトウェア ループバック ネットワーク インターフェイス。
IF_TYPE_ATM
37
 ATM ネットワーク インターフェイス。
IF_TYPE_IEEE80211
71
 IEEE 802.11 ワイヤレス ネットワーク インターフェイス。 Windows Vista 以降では、ワイヤレス ネットワーク カードは IF_TYPE_IEEE80211として報告されます。

Windows Server 2003、Windows 2000 Server SP1 および Windows XP/2000: ワイヤレス ネットワーク カードは 、IF_TYPE_ETHERNET_CSMACDとして報告されます。
IF_TYPE_TUNNEL
131
 トンネル型カプセル化ネットワーク インターフェイス。
IF_TYPE_IEEE1394
144
 IEEE 1394 (Firewire) の高性能シリアル バス ネットワーク インターフェイス。

ConnectionType

種類: UCHAR

アダプターのインターフェイス接続の種類。

このメンバーに指定できる値は、Ipifcons.h ヘッダー ファイルで定義されています。

値 意味
IF_CONNECTION_DEDICATED
1
 接続の種類は専用です。 メディア センスが TRUE の場合、接続は自動的に起動します。 たとえば、イーサネット接続は専用です。
IF_CONNECTION_PASSIVE
2
 接続の種類はパッシブです。 リモート・エンドは、ローカル・ステーションへの接続を起動する必要があります。 たとえば、RAS インターフェイスはパッシブです。
IF_CONNECTION_DEMAND
3
 接続の種類は demand-dial です。 この種類の接続は、ローカル アクション (パケットの送信など) に応答して起動します。

AccessType

種類: UCHAR

インターフェイスのアクセスの種類を指定する IF_ACCESS_TYPE 列挙体の値。

Windows Server 2003、Windows 2000 Server SP1 および Windows XP/2000: このメンバーに指定できる値は、Ipifcons.h ヘッダー ファイルで定義されています。

値 意味
IF_ACCESS_LOOPBACK
1
 ループバック アクセスの種類。 この値は、インターフェイスがループバックしてデータを受信データとして送信することを示します。
IF_ACCESS_BROADCAST
2
 イーサネットを含む LAN アクセスの種類。 この値は、インターフェイスがマルチキャストまたはブロードキャスト サービスのネイティブ サポートを提供することを示します。
IF_ACCESS_POINT_TO_POINT
3
 ポイント対ポイント アクセスの種類。 この値は、非ブロードキャスト マルチアクセス (NBMA) インターフェイスを除き、CoNDIS/WAN のサポートを示します。

Windows Server 2003、Windows 2000 Server SP1 および Windows XP/2000: この値は、Ipifcons.h ヘッダー ファイルで IF_ACCESS_POINTTOPOINT として定義されました。
IF_ACCESS_POINT_TO_MULTI_POINT
4
 ポイントからマルチポイントへのアクセスの種類。 この値は、RAS 内部インターフェイスやネイティブ ATM を含む非ブロードキャスト マルチアクセス メディアのサポートを示します。

Windows Server 2003、Windows 2000 Server SP1 および Windows XP/2000: この値は、Ipifcons.h ヘッダー ファイルで IF_ACCESS_POINTTOMULTIPOINT として定義されています。

DeviceGuid

種類: GUID

インターフェイスの基になるデバイスを識別する GUID。 このメンバーには、0 個の GUID を指定できます。

InterfaceGuid

種類: GUID

デバイスにマップされたインターフェイスを識別する GUID。 省略可能。 このメンバーには、0 個の GUID を指定できます。

注釈

Microsoft Windows ソフトウェア開発キット (Windows SDK) (SDK) では、Windows 2000 Service Pack 1 (SP1) 以降で使用する構造体のバージョンは、IP_INTERFACE_NAME_INFO_W2KSP1として定義されています。 ターゲット プラットフォームが WINDOWS 2000 SP1 以降 (NTDDI_VERSION >= NTDDI_WIN2KSP1、、または WINVER >= 0x0500) である場合にアプリケーションをコンパイルする場合、_WIN32_WINNT >= 0x0500IP_INTERFACE_NAME_INFO_W2KSP1構造体は IP_INTERFACE_NAME_INFO 構造体に型定義されます。

MediaType、ConnectionType、および AccessType のメンバー、定義、および割り当てられた値は、Ipifcons.h ヘッダー ファイルから入手できます。

オプションの InterfaceGuid メンバーは、多くの場合、ダイヤルアップ インターフェイス用に設定され、同じデバイス GUID を共有する複数のダイヤルアップ インターフェイスを区別するために使用できます。

要件

要件 値
サポートされている最小のクライアント Windows XP、Windows 2000 Professional SP1 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003、Windows 2000 Server SP1 [デスクトップ アプリのみ]
Header iptypes.h (Iphlpapi.h を含む)

こちらもご覧ください

GetAdaptersAddresses

NhpAllocateAndGetInterfaceInfoFromStack