estructura ADDRINFOEX6 (ws2def.h)

Artículo
08/28/2023

La estructura addrinfoex4 se usa en la función GetAddrInfoEx para contener información de dirección de host cuando se ha solicitado una interfaz de red específica.

Sintaxis

typedef struct addrinfoex6 {
  int                 ai_flags;
  int                 ai_family;
  int                 ai_socktype;
  int                 ai_protocol;
  size_t              ai_addrlen;
  PWSTR               ai_canonname;
  struct sockaddr     *ai_addr;
  void                *ai_blob;
  size_t              ai_bloblen;
  GUID                *ai_provider;
  struct addrinfoex5  *ai_next;
  int                 ai_version;
  PWSTR               ai_fqdn;
  int                 ai_interfaceindex;
  HANDLE              ai_resolutionhandle;
  unsigned int        ai_ttl;
  unsigned int        ai_numservers;
  ADDRINFO_DNS_SERVER *ai_servers;
  ULONG64             ai_responseflags;
} ADDRINFOEX6, *PADDRINFOEX6;

Miembros

ai_flags

Marcas que indican las opciones usadas en la función GetAddrInfoEx .

Los valores admitidos para el miembro ai_flags se definen en el archivo de inclusión Winsock2.h y pueden ser una combinación de las siguientes opciones.

Value	Significado
AI_PASSIVE 0x01	La dirección del socket se usará en una llamada a la función bind.
AI_CANONNAME 0x02	El nombre canónico se devuelve en el primer miembro ai_canonname .
AI_NUMERICHOST 0x04	El parámetro nodename pasado a la función GetAddrInfoEx debe ser una cadena numérica.
AI_ALL 0x0100	Si se establece este bit, se realiza una solicitud para las direcciones IPv6 e IPv4 con AI_V4MAPPED. Esta opción se admite en Windows Vista y versiones posteriores.
AI_ADDRCONFIG 0x0400	GetAddrInfoEx solo se resolverá si se configura una dirección global. La dirección de bucle invertido IPv6 e IPv4 no se considera una dirección global válida. Esta opción se admite en Windows Vista y versiones posteriores.
AI_V4MAPPED 0x0800	Si se produce un error en la solicitud GetAddrInfoEx para direcciones IPv6, se realiza una solicitud de servicio de nombre para las direcciones IPv4 y estas direcciones se convierten en formato de dirección IPv6 asignada a IPv4. Esta opción se admite en Windows Vista y versiones posteriores.
AI_NON_AUTHORITATIVE 0x04000	La información de dirección procede de resultados no autoritativos. Cuando esta opción se establece en el parámetro pHints de GetAddrInfoEx, el proveedor de espacios de nombres NS_EMAIL devuelve resultados autoritativos y no autoritativos. Si no se establece esta opción, solo se devuelven los resultados autoritativos. Esta opción solo se admite en Windows Vista y versiones posteriores para el espacio de nombres NS_EMAIL .
AI_SECURE 0x08000	La información de dirección procede de un canal seguro. Si se establece el bit de AI_SECURE , el proveedor de espacio de nombres NS_EMAIL devolverá los resultados obtenidos con seguridad mejorada para minimizar la posible suplantación de identidad. Cuando esta opción se establece en el parámetro pHints de GetAddrInfoEx, el proveedor de espacio de nombres NS_EMAIL devuelve solo los resultados obtenidos con seguridad mejorada para minimizar la posible suplantación de identidad. Esta opción solo se admite en Windows Vista y versiones posteriores para el espacio de nombres NS_EMAIL .
AI_RETURN_PREFERRED_NAMES 0x010000	La información de dirección es para los nombres preferidos para la publicación con un espacio de nombres específico. Cuando esta opción se establece en el parámetro pHints de GetAddrInfoEx, no se debe proporcionar ningún nombre en el parámetro pName y el proveedor de espacio de nombres NS_EMAIL devolverá nombres preferidos para la publicación. Esta opción solo se admite en Windows Vista y versiones posteriores para el espacio de nombres NS_EMAIL .
AI_FQDN 0x00020000	El nombre de dominio completo se devuelve en el primer miembro ai_fqdn . Cuando esta opción se establece en el parámetro pHints de GetAddrInfoEx y se especifica un nombre plano (etiqueta única) en el parámetro pName , se devolverá el nombre de dominio completo que finalmente se resolvió. Esta opción se admite en Windows 7, Windows Server 2008 R2 y versiones posteriores.
AI_FILESERVER 0x00040000	Sugerencia al proveedor de espacios de nombres que se está consultando el nombre de host se está usando en un escenario de recurso compartido de archivos. El proveedor de espacios de nombres puede omitir esta sugerencia. Esta opción se admite en Windows 7, Windows Server 2008 R2 y versiones posteriores.
AI_DISABLE_IDN_ENCODING 0x00080000	Deshabilite la codificación automática de nombres de dominio internacionales mediante Punycode en las funciones de resolución de nombres llamadas por la función GetAddrInfoEx . Esta opción se admite en Windows 8, Windows Server 2012 y versiones posteriores.
AI_EXTENDED 0x80000000	Indica que el objeto actual se extiende: es decir, un addrinfoex2 o superior. Esta opción se admite en Windows 8.1, Windows Server 2012 R2 y versiones posteriores.
AI_RESOLUTION_HANDLE 0x40000000	Se devuelve un identificador de resolución en el miembro ai_resolutionhandle . Esta opción se admite en Windows 10, Windows Server 2016 y versiones posteriores.
AI_RETURN_TTL 0x0080	Número de segundos para los que el registro DNS es válido. Si esta marca está presente, GetAddrInfoEx. El parámetro ppResult devolverá una lista de estructuras addrinfoex5 , donde el miembro ai_ttl contendrá el TTL individual del registro DNS.
AI_EXCLUSIVE_CUSTOM_SERVERS 0x0080	De forma predeterminada, los servidores especificados en el miembro ai_servers se usan como reserva para los servidores DNS del sistema. Si se especifica esta opción, la consulta DNS usará los servidores personalizados especificados en ai_server exclusivamente.
AI_RETURN_RESPONSE_FLAGS 0x0080	Solicita información adicional sobre los resultados de DNS. Si esta marca está presente, el parámetro GetAddrInfoExppResult devolverá una lista de estructuras addrinfoex6 , donde el miembro ai_responseflags contendrá información sobre el origen de los resultados de DNS.

ai_family

La familia de direcciones.

Los valores posibles para la familia de direcciones se definen en el archivo de encabezado Ws2def.h . Tenga en cuenta que el archivo de encabezado Ws2def.h se incluye automáticamente en Winsock2.h y nunca se debe usar directamente.

Los valores admitidos actualmente son AF_INET o AF_INET6, que son los formatos de familia de direcciones de Internet para IPv4 e IPv6. Se admiten otras opciones para la familia de direcciones (AF_NETBIOS para su uso con NetBIOS, por ejemplo) si se instala un proveedor de servicios de Windows Sockets para la familia de direcciones. Tenga en cuenta que los valores de la familia de direcciones AF_ y las constantes de familia de protocolos PF_ son idénticas (por ejemplo, AF_INET y PF_INET), por lo que se puede usar cualquiera de las constantes.

En la tabla siguiente se enumeran los valores comunes de la familia de direcciones, aunque muchos otros valores son posibles.

Value	Significado
AF_UNSPEC 0	No se especifica la familia de direcciones.
AF_INET 2	Familia de direcciones del Protocolo de Internet versión 4 (IPv4).
AF_NETBIOS 17	Familia de direcciones NetBIOS. Esta familia de direcciones solo se admite si está instalado un proveedor de Windows Sockets para NetBIOS.
AF_INET6 23	Familia de direcciones del Protocolo de Internet versión 6 (IPv6).
AF_IRDA 26	Familia de direcciones de la Asociación de datos infrarrojos (IrDA). Esta familia de direcciones solo se admite si el equipo tiene instalado un puerto infrarrojo y un controlador.
AF_BTH 32	La familia de direcciones Bluetooth. Esta familia de direcciones solo se admite si se instala un adaptador Bluetooth.

ai_socktype

Tipo de socket. Los valores posibles para el tipo de socket se definen en el archivo de inclusión Winsock2.h .

En la tabla siguiente se enumeran los valores posibles para el tipo de socket admitido para Windows Sockets 2:

Value	Significado
SOCK_STREAM 1	Proporciona secuencias de bytes secuenciadas, confiables y bidireccionales basadas en conexiones con un mecanismo de transmisión de datos OOB. Usa el Protocolo de control de transmisión (TCP) para la familia de direcciones de Internet (AF_INET o AF_INET6). Si el miembro ai_family es AF_IRDA, SOCK_STREAM es el único tipo de socket admitido.
SOCK_DGRAM 2	Admite datagramas, que son búferes no confiables sin conexión con una longitud máxima fija (normalmente corta). Usa el Protocolo de datagramas de usuario (UDP) para la familia de direcciones de Internet (AF_INET o AF_INET6).
SOCK_RAW 3	Proporciona un socket sin formato que permite a una aplicación manipular el siguiente encabezado de protocolo de capa superior. Para manipular el encabezado IPv4, la opción de socket IP_HDRINCL debe establecerse en el socket. Para manipular el encabezado IPv6, la opción de socket IPV6_HDRINCL debe establecerse en el socket.
SOCK_RDM 4	Proporciona un datagrama de mensaje confiable. Un ejemplo de este tipo es la implementación del protocolo multidifusión general pragmático (PGM) en Windows, a menudo denominada programación de multidifusión confiable.
SOCK_SEQPACKET 5	Proporciona un paquete de pseudo streaming basado en datagramas.

En Windows Sockets 2, se introdujeron nuevos tipos de socket. Una aplicación puede detectar dinámicamente los atributos de cada protocolo de transporte disponible a través de la función WSAEnumProtocols . Por lo tanto, una aplicación puede determinar las posibles opciones de tipo de socket y protocolo para una familia de direcciones y usar esta información al especificar este parámetro. Las definiciones de tipo de socket en los archivos de encabezado Winsock2.h y Ws2def.h se actualizarán periódicamente a medida que se definen nuevos tipos de socket, familias de direcciones y protocolos.

En Windows Sockets 1.1, los únicos tipos de socket posibles son SOCK_DATAGRAM y SOCK_STREAM.

ai_protocol

Tipo de protocolo. Las opciones posibles son específicas de la familia de direcciones y el tipo de socket especificado. Los valores posibles para el ai_protocol se definen en Winsock2.h y en los archivos de encabezado Wsrm.h .

En Windows SDK publicado para Windows Vista y versiones posteriores, la organización de los archivos de encabezado ha cambiado y este miembro puede ser uno de los valores del tipo de enumeración IPPROTO definido en el archivo de encabezado Ws2def.h . Tenga en cuenta que el archivo de encabezado Ws2def.h se incluye automáticamente en Winsock2.h y nunca se debe usar directamente.

Si se especifica un valor de 0 para ai_protocol, el autor de la llamada no desea especificar un protocolo y el proveedor de servicios elegirá el ai_protocol que se va a usar. En el caso de los protocolos distintos de IPv4 e IPv6, establezca ai_protocol en cero.

En la tabla siguiente se enumeran los valores comunes para el miembro ai_protocol , aunque muchos otros valores son posibles.

Value	Significado
IPPROTO_TCP 6	Protocolo de control de transmisión (TCP). Se trata de un valor posible cuando el miembro ai_family es AF_INET o AF_INET6 y el miembro ai_socktype es SOCK_STREAM.
IPPROTO_UDP 17	Protocolo de datagramas de usuario (UDP). Se trata de un valor posible cuando el miembro ai_family es AF_INET o AF_INET6 y el parámetro de tipo se SOCK_DGRAM.
IPPROTO_RM 113	Protocolo PGM para multidifusión confiable. Se trata de un valor posible cuando se AF_INET el miembro ai_family y el miembro ai_socktype es SOCK_RDM. En Windows SDK publicado para Windows Vista y versiones posteriores, este valor también se denomina IPPROTO_PGM.

Si el miembro ai_family es AF_IRDA, el ai_protocol debe ser 0.

ai_addrlen

Longitud, en bytes, del búfer al que apunta el miembro ai_addr .

ai_canonname

Nombre canónico del host.

ai_addr

Puntero a una estructura sockaddr . El miembro ai_addr en cada estructura addrinfoex4 devuelta apunta a una estructura de direcciones de socket rellenada. La longitud, en bytes, de cada estructura addrinfoex4 devuelta se especifica en el miembro ai_addrlen .

ai_blob

Puntero a los datos que se usan para devolver información de espacio de nombres específica del proveedor asociada al nombre más allá de una lista de direcciones. La longitud, en bytes, del búfer al que apunta ai_blob debe especificarse en el miembro ai_bloblen .

ai_bloblen

Longitud, en bytes, del miembro ai_blob .

ai_provider

Puntero al GUID de un proveedor de espacio de nombres específico.

ai_next

Puntero a la siguiente estructura de una lista vinculada. Este parámetro se establece en NULL en la última estructura addrinfoex4 de una lista vinculada.

ai_version

Número de versión de esta estructura. El valor que se usa actualmente para esta versión de la estructura es 4.

ai_fqdn

Nombre de dominio completo del host.

ai_interfaceindex

Índice de interfaz, tal y como se define en el IP_ADAPTER_ADDRESSES. Propiedad IfIndex devuelta en GetAdaptersAddresses.

ai_resolutionhandle

Identificador que apunta al nombre de dominio completo del host.

ai_ttl

Número de segundos para los que este registro DNS es válido.

ai_numservers

Número de servidores DNS personalizados presentes en el miembro ai_servers .

ai_servers

Matriz de N (donde N == ai_numservers) ADDRINFO_DNS_SERVER objetos. Si ai_numservers es 0, ai_servers debe ser NULL.

ai_responseflags

Devuelve un mapa de bits que contiene cualquiera de los valores siguientes.

Constante	Value	Significado
AI_DNS_RESPONSE_SECURE	0x1	La respuesta procede de protocolos seguros, como DNS a través de HTTPS.
AI_DNS_RESPONSE_HOSTFILE	0x2	La respuesta procede del archivo hosts .

Observaciones

La estructura ADDRINFOEX6 es una extensión de la estructura ADDRINFOEX5 . Además de todos los campos de la estructura ADDRINFOEX5 , contiene los miembros ai_numservers y ai_servers , lo que permite el uso de servidores DNS personalizados por consulta. También contiene el miembro ai_responseflags , que contiene información sobre el origen de las respuestas DNS.

Si la marca AI_RETURN_RESPONSE_FLAGS está presente en el miembro ai_flags , el parámetro GetAddrInfoExppResult devolverá una lista de estructuras de ADDRINFOEX6 , donde el miembro ai_responseflags contendrá información sobre el origen de los resultados de DNS.

Si los miembros ai_numservers y ai_servers apuntan a una matriz de objetos de ADDRINFO_DNS_SERVER válidos, la consulta DNS agregará estos servidores como reserva a los servidores DNS configurados por el sistema. Si la opción AI_EXCLUSIVE_CUSTOM_SERVERS está presente en el miembro ai_flags , la consulta DNS usará exclusivamente los servidores personalizados.