Compartir a través de


Función GetAnycastIpAddressTable (netioapi.h)

La función GetAnycastIpAddressTable recupera la tabla de direcciones IP de difusión en el equipo local.

Sintaxis

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetAnycastIpAddressTable(
  [in]  ADDRESS_FAMILY              Family,
  [out] PMIB_ANYCASTIPADDRESS_TABLE *Table
);

Parámetros

[in] Family

Familia de direcciones que se va a recuperar.

Los valores posibles para la familia de direcciones se enumeran en el archivo de encabezado Winsock2.h . 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 el Windows SDK publicado para Windows Vista y versiones posteriores, la organización de archivos de encabezado ha cambiado y los valores posibles para este miembro 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, AF_INET6 y AF_UNSPEC.

Valor Significado
AF_UNSPEC
0
No se especifica la familia de direcciones. Cuando se especifica este parámetro, esta función devuelve la tabla de direcciones IP de difusión que contiene entradas IPv4 e IPv6.
AF_INET
2
Familia de direcciones del Protocolo de Internet versión 4 (IPv4). Cuando se especifica este parámetro, esta función devuelve la tabla de direcciones IP de difusión que contiene solo entradas IPv4.
AF_INET6
23
Familia de direcciones del Protocolo de Internet versión 6 (IPv6). Cuando se especifica este parámetro, esta función devuelve la tabla de direcciones IP de difusión que contiene solo entradas IPv6.

[out] Table

Puntero a una estructura de MIB_ANYCASTIPADDRESS_TABLE que contiene una tabla de entradas de dirección IP de difusión en el equipo local.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Código devuelto Descripción
ERROR_INVALID_PARAMETER
Se pasó un parámetro no válido a la función. Este error se devuelve si se pasa un puntero NULL en el parámetro Table o el parámetro Family no se especificó como AF_INET, AF_INET6 o AF_UNSPEC.
ERROR_NOT_ENOUGH_MEMORY
Los recursos de memoria insuficientes están disponibles para completar la operación.
ERROR_NOT_FOUND
No se encontraron entradas de dirección IP de difusión como se especifica en el parámetro Family .
ERROR_NOT_SUPPORTED
No se admite la solicitud. Este error se devuelve si no hay ninguna pila IPv4 en el equipo local y AF_INET se especificó en el parámetro Family . Este error también se devuelve si no hay ninguna pila IPv6 en el equipo local y AF_INET6 se especificó en el parámetro Family . Este error también se devuelve en las versiones de Windows en las que no se admite esta función.
Otros
Use FormatMessage para obtener la cadena de mensaje para el error devuelto.

Comentarios

La función GetAnycastIpAddressTable se define en Windows Vista y versiones posteriores.

The
La función GetAnycastIpAddressTable enumera las direcciones IP de difusión en un sistema local y devuelve esta información en una estructura de MIB_ANYCASTIPADDRESS_TABLE .

Las entradas de dirección IP de difusión se devuelven en una estructura de MIB_ANYCASTIPADDRESS_TABLE en el búfer al que apunta el parámetro Table . La estructura MIB_ANYCASTIPADDRESS_TABLE contiene un recuento de entradas de direcciones IP de difusión y una matriz de estructuras de MIB_ANYCASTIPADDRESS_ROW para cada entrada de dirección IP de difusión. Cuando estas estructuras devueltas ya no son necesarias, libere la memoria llamando a FreeMibTable.

El parámetro Family debe inicializarse en AF_INET, AF_INET6 o AF_UNSPEC.

Tenga en cuenta que la estructura de MIB_ANYCASTIPADDRESS_TABLE devuelta a la que apunta el parámetro Table puede contener relleno para la alineación entre el miembro NumEntries y la primera entrada de matriz MIB_ANYCASTIPADDRESS_ROW en el miembro Table de la estructura MIB_ANYCASTIPADDRESS_TABLE . El relleno para la alineación también puede estar presente entre las entradas de matriz de MIB_ANYCASTIPADDRESS_ROW . Cualquier acceso a una entrada de matriz de MIB_ANYCASTIPADDRESS_ROW debe suponer que puede existir relleno.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado netioapi.h (include Iphlpapi.h)
Library Iphlpapi.lib
Archivo DLL Iphlpapi.dll

Consulte también

FreeMibTable

MIB_ANYCASTIPADDRESS_ROW

MIB_ANYCASTIPADDRESS_TABLE