Función GetIpNetTable (iphlpapi.h)
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 |
---|---|
|
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 . |
|
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 . |
|
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. |
|
El transporte IPv4 no está configurado en el equipo local. |
|
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 |
Consulte también
Referencia de la función auxiliar de IP