estructura IP_INTERFACE_NAME_INFO_W2KSP1 (iptypes.h)

  • Artículo

La estructura IP_INTERFACE_NAME_INFO contiene información sobre una interfaz IPv4 en el equipo local.

Sintaxis

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;

Miembros

Index

Tipo: ULONG

Índice de la interfaz IP de la instancia activa.

MediaType

Tipo: ULONG

Tipo de interfaz definido por la Autoridad de nombres asignados a Internet (IANA). Los valores posibles para el tipo de interfaz se enumeran en el archivo de encabezado Ipifcons.h.

En la tabla siguiente se enumeran los valores comunes para el tipo de interfaz; aunque, muchos otros valores son posibles.

Valor Significado
IF_TYPE_OTHER
1
 Otro tipo de interfaz de red.
IF_TYPE_ETHERNET_CSMACD
6
 Una interfaz de red Ethernet.
IF_TYPE_ISO88025_TOKENRING
9
 Interfaz de red de anillo de token.
IF_TYPE_PPP
23
 Una interfaz de red PPP.
IF_TYPE_SOFTWARE_LOOPBACK
24
 Interfaz de red de bucle invertido de software.
IF_TYPE_ATM
37
 Una interfaz de red ATM.
IF_TYPE_IEEE80211
71
 Interfaz de red inalámbrica IEEE 802.11. En Windows Vista y versiones posteriores, las tarjetas de red inalámbricas se notifican como IF_TYPE_IEEE80211.

Windows Server 2003, Windows 2000 Server con SP1 y Windows XP/2000: Las tarjetas de red inalámbricas se notifican como IF_TYPE_ETHERNET_CSMACD.
IF_TYPE_TUNNEL
131
 Interfaz de red de encapsulación de tipos de túnel.
IF_TYPE_IEEE1394
144
 Interfaz de red de bus serie de alto rendimiento IEEE 1394 (Firewire).

ConnectionType

Tipo: UCHAR

Tipo de conexión de interfaz para el adaptador.

Los valores posibles para este miembro se definen en el archivo de encabezado Ipifcons.h.

Valor Significado
IF_CONNECTION_DEDICATED
1
 El tipo de conexión está dedicado. La conexión aparece automáticamente cuando el sentido multimedia es TRUE. Por ejemplo, una conexión Ethernet está dedicada.
IF_CONNECTION_PASSIVE
2
 El tipo de conexión es pasivo. El extremo remoto debe abrir la conexión a la estación local. Por ejemplo, una interfaz RAS es pasiva.
IF_CONNECTION_DEMAND
3
 El tipo de conexión es de marcado a petición. Una conexión de este tipo aparece en respuesta a una acción local (por ejemplo, el envío de un paquete).

AccessType

Tipo: UCHAR

Valor de la enumeración IF_ACCESS_TYPE que especifica el tipo de acceso para la interfaz.

Windows Server 2003, Windows 2000 Server con SP1 y Windows XP/2000: Los valores posibles para este miembro se definen en el archivo de encabezado Ipifcons.h.

Valor Significado
IF_ACCESS_LOOPBACK
1
 Tipo de acceso de bucle invertido. Este valor indica que la interfaz vuelve a transmitir datos como datos de recepción.
IF_ACCESS_BROADCAST
2
 Tipo de acceso LAN que incluye Ethernet. Este valor indica que la interfaz proporciona compatibilidad nativa con servicios de multidifusión o difusión.
IF_ACCESS_POINT_TO_POINT
3
 Tipo de acceso de punto a punto. Este valor indica la compatibilidad con CoNDIS/WAN, excepto para las interfaces de acceso múltiple (NBMA) que no son de difusión.

Windows Server 2003, Windows 2000 Server con SP1 y Windows XP/2000: Este valor se definió como IF_ACCESS_POINTTOPOINT en el archivo de encabezado Ipifcons.h.
IF_ACCESS_POINT_TO_MULTI_POINT
4
 Tipo de acceso de punto a punto múltiple. Este valor indica la compatibilidad con medios de acceso múltiple que no son de difusión, incluida la interfaz interna ras y el cajero automático nativo.

Windows Server 2003, Windows 2000 Server con SP1 y Windows XP/2000: Este valor se definió como IF_ACCESS_POINTTOMULTIPOINT en el archivo de encabezado Ipifcons.h.

DeviceGuid

Tipo: GUID

GUID que identifica el dispositivo subyacente para la interfaz. Este miembro puede ser un GUID cero.

InterfaceGuid

Tipo: GUID

GUID que identifica la interfaz asignada al dispositivo. Opcional. Este miembro puede ser un GUID cero.

Comentarios

En Microsoft Kit de desarrollo de software de Windows (SDK), la versión de la estructura para su uso en Windows 2000 con Service Pack 1 (SP1) y versiones posteriores se define como IP_INTERFACE_NAME_INFO_W2KSP1. Al compilar una aplicación si la plataforma de destino es Windows 2000 con SP1 y versiones posteriores (NTDDI_VERSION >= NTDDI_WIN2KSP1, _WIN32_WINNT >= 0x0500o WINVER >= 0x0500), la estructura de IP_INTERFACE_NAME_INFO_W2KSP1 se escribe en la estructura de IP_INTERFACE_NAME_INFO .

Los miembros MediaType, ConnectionType y AccessType , las definiciones y los valores asignados están disponibles en el archivo de encabezado Ipifcons.h.

El miembro interfaceGuid opcional se establece a menudo para las interfaces de acceso telefónico y se puede usar para distinguir varias interfaces de acceso telefónico que comparten el mismo GUID de dispositivo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP, Windows 2000 Professional con SP1 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003, Windows 2000 Server con SP1 [solo aplicaciones de escritorio]
Encabezado iptypes.h (include Iphlpapi.h)

Consulte también

GetAdaptersAddresses

NhpAllocateAndGetInterfaceInfoFromStack