estrutura IP_INTERFACE_NAME_INFO_W2KSP1 (iptypes.h)

A estrutura IP_INTERFACE_NAME_INFO contém informações sobre uma interface IPv4 no computador local.

Sintaxe

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;

Membros

Index

Tipo: ULONG

O índice da interface IP da instância ativa.

MediaType

Tipo: ULONG

O tipo de interface conforme definido pela IANA (Autoridade de Nomes Atribuídos à Internet). Os valores possíveis para o tipo de interface são listados no arquivo de cabeçalho Ipifcons.h.

A tabela a seguir lista valores comuns para o tipo de interface; embora, muitos outros valores sejam possíveis.

Valor	Significado
IF_TYPE_OTHER 1	Algum outro tipo de adaptador de rede.
IF_TYPE_ETHERNET_CSMACD 6	Um adaptador de rede Ethernet.
IF_TYPE_ISO88025_TOKENRING 9	Um adaptador de rede de anel de token.
IF_TYPE_PPP 23	Um adaptador de rede PPP.
IF_TYPE_SOFTWARE_LOOPBACK 24	Um adaptador de rede de loopback de software.
IF_TYPE_ATM 37	Um adaptador de rede atm.
IF_TYPE_IEEE80211 71	Um adaptador de rede sem fio IEEE 802.11. No Windows Vista e posterior, cartões de rede sem fio são relatados como IF_TYPE_IEEE80211. Windows Server 2003, Windows 2000 Server com SP1 e Windows XP/2000: Cartões de rede sem fio são relatados como IF_TYPE_ETHERNET_CSMACD.
IF_TYPE_TUNNEL 131	Um adaptador de rede de encapsulamento de tipo de túnel.
IF_TYPE_IEEE1394 144	Um adaptador de rede de barramento serial de alto desempenho do IEEE 1394 (Firewire).

ConnectionType

Tipo: UCHAR

O tipo de conexão de interface para o adaptador.

Os valores possíveis para esse membro são definidos no arquivo de cabeçalho Ipifcons.h.

Valor	Significado
IF_CONNECTION_DEDICATED 1	O tipo de conexão é dedicado. A conexão aparece automaticamente quando o sentido de mídia é TRUE. Por exemplo, uma conexão Ethernet é dedicada.
IF_CONNECTION_PASSIVE 2	O tipo de conexão é passivo. A extremidade remota deve abrir a conexão com a estação local. Por exemplo, uma interface RAS é passiva.
IF_CONNECTION_DEMAND 3	O tipo de conexão é demand-dial. Uma conexão desse tipo aparece em resposta a uma ação local (enviando um pacote, por exemplo).

AccessType

Tipo: UCHAR

Um valor da enumeração IF_ACCESS_TYPE que especifica o tipo de acesso para a interface.

Windows Server 2003, Windows 2000 Server com SP1 e Windows XP/2000: Os valores possíveis para esse membro são definidos no arquivo de cabeçalho Ipifcons.h.

Valor	Significado
IF_ACCESS_LOOPBACK 1	O tipo de acesso de loopback. Esse valor indica que a interface faz loops de transmissão de dados como dados de recebimento.
IF_ACCESS_BROADCAST 2	O tipo de acesso LAN que inclui Ethernet. Esse valor indica que a interface fornece suporte nativo para serviços multicast ou de difusão.
IF_ACCESS_POINT_TO_POINT 3	O tipo de acesso ponto a ponto. Esse valor indica suporte para CoNDIS/WAN, exceto para interfaces NBMA (multi-acesso não difundido). Windows Server 2003, Windows 2000 Server com SP1 e Windows XP/2000: Esse valor foi definido como IF_ACCESS_POINTTOPOINT no arquivo de cabeçalho Ipifcons.h.
IF_ACCESS_POINT_TO_MULTI_POINT 4	O tipo de acesso ponto a vários pontos. Esse valor indica suporte para mídia de acesso múltiplo não difundido, incluindo a interface interna ras e o ATM nativo. Windows Server 2003, Windows 2000 Server com SP1 e Windows XP/2000: Esse valor foi definido como IF_ACCESS_POINTTOMULTIPOINT no arquivo de cabeçalho Ipifcons.h.

DeviceGuid

Tipo: GUID

O GUID que identifica o dispositivo subjacente para a interface. Esse membro pode ser um GUID zero.

InterfaceGuid

Tipo: GUID

O GUID que identifica a interface mapeada para o dispositivo. Opcional. Esse membro pode ser um GUID zero.

Comentários

No Microsoft Software Development Kit do Windows (SDK do Windows) (SDK), a versão da estrutura para uso no Windows 2000 com Service Pack 1 (SP1) e posterior é definida como IP_INTERFACE_NAME_INFO_W2KSP1. Ao compilar um aplicativo se a plataforma de destino for o Windows 2000 com SP1 e posterior (NTDDI_VERSION >= NTDDI_WIN2KSP1, _WIN32_WINNT >= 0x0500ou WINVER >= 0x0500), a estrutura IP_INTERFACE_NAME_INFO_W2KSP1 será digitada para a estrutura IP_INTERFACE_NAME_INFO .

Os membros MediaType, ConnectionType e AccessType , definições e valores atribuídos estão disponíveis no arquivo de cabeçalho Ipifcons.h.

O membro InterfaceGuid opcional geralmente é definido para interfaces de discagem e pode ser usado para distinguir várias interfaces discadas que compartilham o mesmo GUID do dispositivo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP, Windows 2000 Professional com SP1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003, Windows 2000 Server com SP1 [somente aplicativos da área de trabalho]
Cabeçalho	iptypes.h (inclua Iphlpapi.h)

Confira também

Getadaptersaddresses

NhpAllocateAndGetInterfaceInfoFromStack