IP_INTERFACE_NAME_INFO_W2KSP1 structure (iptypes.h)
The IP_INTERFACE_NAME_INFO structure contains information about an IPv4 interface on the local computer.
Syntax
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;
Members
Index
Type: ULONG
The index of the IP interface for the active instance.
MediaType
Type: ULONG
The interface type as defined by the Internet Assigned Names Authority (IANA). Possible values for the interface type are listed in the Ipifcons.h header file.
The table below lists common values for the interface type; although, many other values are possible.
ConnectionType
Type: UCHAR
The interface connection type for the adapter.
The possible values for this member are defined in the Ipifcons.h header file.
AccessType
Type: UCHAR
A value of the IF_ACCESS_TYPE enumeration that specifies the access type for the interface.
Windows Server 2003, Windows 2000 Server with SP1 and Windows XP/2000: The possible values for this member are defined in the Ipifcons.h header file.
DeviceGuid
Type: GUID
The GUID that identifies the underlying device for the interface. This member can be a zero GUID.
InterfaceGuid
Type: GUID
The GUID that identifies the interface mapped to the device. Optional. This member can be a zero GUID.
Remarks
In the Microsoft Windows Software Development Kit (SDK), the version of the structure for use on Windows 2000 with Service Pack 1 (SP1) and later is defined as IP_INTERFACE_NAME_INFO_W2KSP1. When compiling an application if the target platform is Windows 2000 with SP1 and later (NTDDI_VERSION >= NTDDI_WIN2KSP1
, _WIN32_WINNT >= 0x0500
, or WINVER >= 0x0500
), the IP_INTERFACE_NAME_INFO_W2KSP1 structure is typedefed to the IP_INTERFACE_NAME_INFO structure.
The MediaType, ConnectionType, and AccessType members, definitions and assigned values are available from the Ipifcons.h header file.
The optional InterfaceGuid member is often set for dial-up interfaces, and can be used to distinguish multiple dial-up interfaces that share the same device GUID.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows XP, Windows 2000 Professional with SP1 [desktop apps only] |
Minimum supported server | Windows Server 2003, Windows 2000 Server with SP1 [desktop apps only] |
Header | iptypes.h (include Iphlpapi.h) |