Administración de direcciones IP mediante GetIpAddrTable
La función GetIpAddrTable rellena un puntero a una estructura de MIB_IPADDRTABLE con información sobre las direcciones IP actuales asociadas al sistema.
Para usar GetIpAddrTable
Declare un puntero a un objeto MIB_IPADDRTABLE denominado pIPAddrTable y un objeto DWORD denominado dwSize. Estas variables se pasan como parámetros a la función GetIpAddrTable . Cree también una variable DWORD denominada dwRetVal (se usa para la comprobación de errores).
MIB_IPADDRTABLE *pIPAddrTable; DWORD dwSize = 0; DWORD dwRetVal;
Asigne memoria para la estructura.
Nota:
El tamaño de dwSize no es suficiente para contener la información. Vea el paso siguiente.
pIPAddrTable = (MIB_IPADDRTABLE*) malloc( sizeof(MIB_IPADDRTABLE) );
Realice una llamada inicial a GetIpAddrTable para obtener el tamaño necesario en la variable dwSize .
Nota
Esta llamada a la función está pensada para producir un error y se usa para asegurarse de que la variable dwSize especifica un tamaño suficiente para contener toda la información devuelta a pIPAddrTable. Se trata de un modelo de programación común para estructuras de datos y funciones de este tipo.
if (GetIpAddrTable(pIPAddrTable, &dwSize, 0) == ERROR_INSUFFICIENT_BUFFER) { free( pIPAddrTable ); pIPAddrTable = (MIB_IPADDRTABLE *) malloc ( dwSize ); }
Realice una segunda llamada a GetIpAddrTable con comprobación de errores general y devuelva su valor a la variable DWORD dwRetVal (para una comprobación de errores más avanzada).
if ( (dwRetVal = GetIpAddrTable( pIPAddrTable, &dwSize, 0 )) != NO_ERROR ) { printf("GetIpAddrTable call failed with %d\n", dwRetVal); }
Si la llamada se realizó correctamente, acceda a los datos desde la estructura de datos pIPAddrTable .
printf("IP Address: %ld\n", pIPAddrTable->table[0].dwAddr); printf("IP Mask: %ld\n", pIPAddrTable->table[0].dwMask); printf("IF Index: %ld\n", pIPAddrTable->table[0].dwIndex); printf("Broadcast Addr: %ld\n", pIPAddrTable->table[0].dwBCastAddr); printf("Re-assembly size: %ld\n", pIPAddrTable->table[0].dwReasmSize);
Libere cualquier memoria asignada para la estructura pIPAddrTable .
if (pIPAddrTable) free(pIPAddrTable);
Nota:
Los objetos DWORD dwAddr y dwMask se devuelven como valores numéricos en el orden de bytes del host, no como orden de bytes de red. Estos valores no son direcciones IP de puntos.
Paso siguiente: Administración de concesiones dhcp mediante IpReleaseAddress y IpRenewAddress
Paso anterior: Administrar interfaces mediante GetInterfaceInfo