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	點對點存取類型。 這個值表示 CoNDIS/WAN 的支援，但非廣播多重存取 (NBMA) 介面除外。 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。 此成員可以是零 GUID。

InterfaceGuid

類型： GUID

識別對應至裝置之介面的 GUID。 選擇性。 此成員可以是零 GUID。

備註

在 Microsoft Windows 軟體開發套件 (SDK) 中，Windows 2000 service Pack 1 (SP1) 及更新版本的 結構版本會定義為IP_INTERFACE_NAME_INFO_W2KSP1。 當編譯應用程式時，如果目標平臺是 Windows 2000 SP1 和更新版本， (NTDDI_VERSION >= NTDDI_WIN2KSP1、 _WIN32_WINNT >= 0x0500或 WINVER >= 0x0500) ，IP_INTERFACE_NAME_INFO_W2KSP1 結構會依 IP_INTERFACE_NAME_INFO 結構進行類型定義。

MediaType、ConnectionType 和 AccessType 成員、定義和指派的值可從 Ipifcons.h 頭檔取得。

選擇性 InterfaceGuid 成員通常會設定為撥號介面，而且可用來區分共用相同裝置 GUID 的多個撥號介面。

規格需求

需求	值
最低支援的用戶端	Windows XP，Windows 2000 專業版 SP1 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003、具有 SP1 的 Windows 2000 Server [僅限桌面應用程式]
標頭	iptypes.h (包含 Iphlpapi.h)

另請參閱

GetAdaptersAddresses

NhpAllocateAndGetInterfaceInfoFromStack