estructura ADDRINFOEX2W (ws2def.h)
La estructura addrinfoex2 se usa en la función GetAddrInfoEx para contener información de dirección de host cuando se ha solicitado un nombre canónico y un nombre de dominio completo.
Sintaxis
typedef struct addrinfoex2W {
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;
LPGUID ai_provider;
struct addrinfoex2W *ai_next;
int ai_version;
PWSTR ai_fqdn;
} ADDRINFOEX2W, *PADDRINFOEX2W, *LPADDRINFOEX2W;
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 |
|---|---|
|
La dirección del socket se usará en una llamada a la función bind . |
|
El nombre canónico se devuelve en el primer miembro ai_canonname . |
|
El parámetro nodename pasado a la función GetAddrInfoEx debe ser una cadena numérica. |
|
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. |
|
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. |
|
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. |
|
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 . |
|
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 . |
|
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 . |
|
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. |
|
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. |
|
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_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.
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 |
|---|---|
|
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. |
|
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). |
|
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. |
|
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. |
|
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.
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 addrinfoex2 devuelta apunta a una estructura de direcciones de socket rellenada. La longitud, en bytes, de cada estructura addrinfoex2 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 addrinfoex2 de una lista vinculada.
ai_version
Número de versión de esta estructura. El valor usado actualmente para esta versión de la estructura es 2.
ai_fqdn
Nombre de dominio completo del host.
Observaciones
La estructura addrinfoex2 se admite en Windows 8 y Windows Server 2012
La función GetAddrInfoExEx usa la estructura addrinfoex2 para contener información de dirección de host cuando los bits de AI_FQDN y AI_CANONNAME se establecen en el miembro ai_flags de la estructura addrinfoex opcional proporcionada en el parámetro hints a la función GetAddrInfoEx. La estructura addrinfoex2 es una versión mejorada de la estructura addrinfoex que puede devolver el nombre canónico y el nombre de dominio completo para el host. Los miembros de estructura adicionales son para un número de versión de la estructura y el nombre de dominio completo para el host.
La estructura addrinfoex2 usada con la función GetAddrInfoEx es una versión mejorada de las estructuras addrinfo y addrinfoW usadas con las funciones getaddrinfo y GetAddrInfoW . La función GetAddrInfoEx permite especificar el proveedor de espacios de nombres para resolver la consulta. Para su uso con el protocolo IPv6 e IPv4, la resolución de nombres puede ser por el Sistema de nombres de dominio (DNS), un archivo de hosts local, un proveedor de correo electrónico (el espacio de nombres NS_EMAIL ) o por otros mecanismos de nomenclatura.
Los datos de blob de tha ai_blob miembro se usan para devolver información adicional del espacio de nombres específico del proveedor asociada a un nombre. El formato de los datos del miembro ai_blob es específico de un proveedor de espacios de nombres determinado. Actualmente, el proveedor de espacio de nombres NS_EMAIL usa los datos de blob para proporcionar información adicional.
Cuando se define UNICODE o _UNICODE, se define addrinfoex2 para addrinfoex2W, la versión Unicode de esta estructura. Los parámetros de cadena se definen en el tipo de datos PWSTR y se usa la estructura addrinfoex2W .
Cuando no se define UNICODE o _UNICODE, addrinfoex2 se define en addrinfoex2A, la versión ANSI de esta estructura. Los parámetros de cadena son del tipo de datos char * y se usa la estructura addrinfoex2A .
Tras una llamada correcta a GetAddrInfoEx, se devuelve una lista vinculada de estructuras addrinfoex2 en el parámetro ppResult pasado a la función GetAddrInfoEx . La lista se puede procesar siguiendo el puntero proporcionado en el miembro ai_next de cada estructura addrinfoex2 devuelta hasta que se encuentre un puntero NULL . En cada estructura addrinfoex2 devuelta, los miembros ai_family, ai_socktype y ai_protocol corresponden a argumentos respectivos en una llamada de función de socket o WSASocket . Además, el miembro ai_addr en cada estructura addrinfoex2 devuelta apunta a una estructura de direcciones de socket rellenada, cuya longitud se especifica en su miembro ai_addrlen .
Requisitos
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Encabezado | ws2def.h |