Función GetIpNetTable (iphlpapi.h)

Artículo
02/28/2024

La función GetIpNetTable recupera la tabla de asignación de direcciones físicas IPv4.

Sintaxis

IPHLPAPI_DLL_LINKAGE ULONG GetIpNetTable(
  [out]     PMIB_IPNETTABLE IpNetTable,
  [in, out] PULONG          SizePointer,
  [in]      BOOL            Order
);

Parámetros

[out] IpNetTable

Puntero a un búfer que recibe la tabla de asignación de direcciones físicas IPv4 como una estructura de MIB_IPNETTABLE .

[in, out] SizePointer

En la entrada, especifica el tamaño en bytes del búfer al que apunta el parámetro pIpNetTable .

En la salida, si el búfer no es lo suficientemente grande como para contener la tabla de asignación devuelta, la función establece este parámetro igual al tamaño de búfer necesario en bytes.

[in] Order

Valor booleano que especifica si la tabla de asignación devuelta debe ordenarse en orden ascendente por dirección IP. Si este parámetro es TRUE, la tabla se ordena.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es NO_ERROR o ERROR_NO_DATA.

Si se produce un error en la función o no devuelve ningún dato, el valor devuelto es uno de los siguientes códigos de error.

Código devuelto	Descripción
ERROR_INSUFFICIENT_BUFFER	El búfer al que apunta el parámetro pIpNetTable no es lo suficientemente grande. El tamaño necesario se devuelve en la variable DWORD a la que apunta el parámetro pdwSize .
ERROR_INVALID_PARAMETER	Se pasó un parámetro no válido a la función. Este error se devuelve si el parámetro pdwSize es NULL o GetIpNetTable no puede escribir en la memoria a la que apunta el parámetro pdwSize .
ERROR_NO_DATA	No hay datos que devolver. La tabla de asignación de direcciones físicas IPv4 está vacía. Este valor devuelto indica que la llamada a la función GetIpNetTable se realizó correctamente, pero no había datos que devolver.
ERROR_NOT_SUPPORTED	El transporte IPv4 no está configurado en el equipo local.
Otros	Use FormatMessage para obtener la cadena de mensaje del error devuelto.

Comentarios

The
La función GetIpNetTable enumera las entradas del Protocolo de resolución de direcciones (ARP) para IPv4 en un sistema local de la tabla de asignación de direcciones físicas IPv4 y devuelve esta información en una estructura de MIB_IPNETTABLE .

Las entradas de dirección IPv4 se devuelven en una estructura de MIB_IPNETTABLE en el búfer al que apunta el parámetro pIpNetTable . La estructura MIB_IPNETTABLE contiene un recuento de entradas ARP y una matriz de estructuras de MIB_IPNETROW para cada entrada de dirección IPv4.

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

en Windows Vista y versiones posteriores, se puede usar la función GetIpNetTable2 para recuperar las direcciones IP vecinas para IPv6 e IPv4.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	iphlpapi.h
Library	Iphlpapi.lib
Archivo DLL	Iphlpapi.dll