IP_ADAPTER_UNICAST_ADDRESS_XP estructura (iptypes.h)

Artículo
08/24/2023

La estructura de IP_ADAPTER_UNICAST_ADDRESS almacena una única dirección IP de unidifusión en una lista vinculada de direcciones IP para un adaptador determinado.

Sintaxis

typedef struct _IP_ADAPTER_UNICAST_ADDRESS_XP {
  union {
    ULONGLONG Alignment;
    struct {
      ULONG Length;
      DWORD Flags;
    };
  };
  struct _IP_ADAPTER_UNICAST_ADDRESS_XP *Next;
  SOCKET_ADDRESS                        Address;
  IP_PREFIX_ORIGIN                      PrefixOrigin;
  IP_SUFFIX_ORIGIN                      SuffixOrigin;
  IP_DAD_STATE                          DadState;
  ULONG                                 ValidLifetime;
  ULONG                                 PreferredLifetime;
  ULONG                                 LeaseLifetime;
} IP_ADAPTER_UNICAST_ADDRESS_XP, *PIP_ADAPTER_UNICAST_ADDRESS_XP;

Members

Alignment

Tipo: ULONGLONG

Reservado. Usado por el compilador para alinear la estructura.

Length

Tipo: ULONG

Longitud, en bytes, de esta estructura.

Flags

Tipo: DWORD

Un conjunto de marcas para esta dirección IP.

En la tabla siguiente se muestran los valores posibles. Estas constantes se definen en el archivo de encabezado Iptypes.h .

Valor	Significado
IP_ADAPTER_ADDRESS_DNS_ELIGIBLE	La dirección IP es legal para que aparezca en DNS.
IP_ADAPTER_ADDRESS_TRANSIENT	La dirección IP es una dirección de clúster y la mayoría de las aplicaciones no deben usarse.

Next

Tipo: struct _IP_ADAPTER_UNICAST_ADDRESS*

Puntero a la siguiente estructura de direcciones del adaptador IP de la lista.

Address

Tipo: SOCKET_ADDRESS

Dirección IP de esta entrada de dirección IP de unidifusión. Este miembro puede ser una dirección IPv6 o una dirección IPv4.

PrefixOrigin

Tipo: IP_PREFIX_ORIGIN

Prefijo o parte de red de la dirección IP. Este miembro puede ser uno de los valores del tipo de enumeración IP_PREFIX_ORIGIN definido en el archivo de encabezado Iptypes.h .

SuffixOrigin

Tipo: IP_SUFFIX_ORIGIN

Sufijo o parte host de la dirección IP. Este miembro puede ser uno de los valores del tipo de enumeración IP_SUFFIX_ORIGIN definido en el archivo de encabezado Iptypes.h .

DadState

Tipo: IP_DAD_STATE

Estado de detección de direcciones duplicadas (DAD). Este miembro puede ser uno de los valores del tipo de enumeración IP_DAD_STATE definido en el archivo de encabezado Iptypes.h . La detección de direcciones duplicadas está disponible para direcciones IPv4 e IPv6.

ValidLifetime

Tipo: ULONG

Duración máxima, en segundos, que la dirección IP es válida. Un valor de 0xffffffff se considera infinito.

PreferredLifetime

Tipo: ULONG

La duración preferida, en segundos, de que la dirección IP es válida. Un valor de 0xffffffff se considera infinito.

LeaseLifetime

Tipo: ULONG

Duración de la concesión, en segundos, que la dirección IP es válida.

Comentarios

La estructura IP_ADAPTER_ADDRESSES se recupera mediante la función GetAdaptersAddresses . El miembro FirstUnicastAddress de la estructura IP_ADAPTER_ADDRESSES es un puntero a una lista vinculada de estructuras de IP_ADAPTER_UNICAST_ADDRESS .

El tamaño de la estructura de IP_ADAPTER_UNICAST_ADDRESS cambió en Windows Vista y versiones posteriores. El miembro Length debe usarse para determinar qué versión de la estructura de IP_ADAPTER_UNICAST_ADDRESS se usa.

La versión de la estructura de IP_ADAPTER_UNICAST_ADDRESS en Windows Vista y versiones posteriores tiene agregado el siguiente nuevo miembro: OnLinkPrefixLength.

Cuando esta estructura se usa con la función GetAdaptersAddresses y funciones de administración similares, se muestran todas las direcciones configuradas, incluidas las direcciones duplicadas. Estas entradas de dirección duplicadas pueden producirse cuando las direcciones se configuran estáticamente. Este informe facilita la solución de problemas del administrador. El miembro dadState es eficaz para identificar y solucionar estas situaciones.

En Windows SDK, la versión de la estructura para su uso en Windows Vista y versiones posteriores se define como IP_ADAPTER_UNICAST_ADDRESS_LH. En Windows SDK, la versión de esta estructura que se usará en sistemas anteriores, incluido Windows XP con Service Pack 1 (SP1) y versiones posteriores se define como IP_ADAPTER_UNICAST_ADDRESS_XP. Al compilar una aplicación si la plataforma de destino es Windows Vista y versiones posteriores (NTDDI_VERSION >= NTDDI_VISTA, _WIN32_WINNT >= 0x0600o WINVER >= 0x0600), la estructura de IP_ADAPTER_UNICAST_ADDRESS_LH se escribe en la estructura IP_ADAPTER_UNICAST_ADDRESS . Al compilar una aplicación si la plataforma de destino no es Windows Vista y versiones posteriores, la estructura de IP_ADAPTER_UNICAST_ADDRESS_XP se escribe en la estructura IP_ADAPTER_UNICAST_ADDRESS .

La estructura SOCKET_ADDRESS se usa en la estructura IP_ADAPTER_UNICAST_ADDRESS . En el Kit de desarrollo de software (SDK) de Microsoft Windows publicado para Windows Vista y versiones posteriores, la organización de archivos de encabezado ha cambiado y la estructura de SOCKET_ADDRESS se define en el archivo de encabezado Ws2def.h que el archivo de encabezado Winsock2.h incluye automáticamente. En el Kit de desarrollo de software de plataforma (SDK) publicado para Windows Server 2003 y Windows XP, la estructura de SOCKET_ADDRESS se declara en el archivo de encabezado Winsock2.h . Para usar la estructura IP_ADAPTER_UNICAST_ADDRESS , el archivo de encabezado Winsock2.h debe incluirse antes del archivo de encabezado Iphlpapi.h .

Requisitos


Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	iptypes.h (include Iphlpapi.h)