Función DhcpScanDatabase (dhcpsapi.h)

La función DhcpScanDatabase enumera las direcciones IPv4 de cliente DHCPv4 alquiladas que no están sincronizadas entre la memoria caché en memoria y la base de datos del servidor.

Sintaxis

DWORD DHCP_API_FUNCTION DhcpScanDatabase(
  [in]  DHCP_CONST WCHAR *ServerIpAddress,
  [in]  DHCP_IP_ADDRESS  SubnetAddress,
  [in]  DWORD            FixFlag,
  [out] LPDHCP_SCAN_LIST *ScanList
);

Parámetros

[in] ServerIpAddress

Cadena Unicode que especifica la dirección IP o el nombre de host del servidor DHCP.

[in] SubnetAddress

DHCP_IP_ADDRESS valor que especifica la subred cuyas concesiones se analizarán para las direcciones IP de concesión de cliente desincrónicas.

[in] FixFlag

Especifica un conjunto de marcas de bits que indican si la memoria caché en memoria o la base de datos de concesión de cliente deben ser el origen definitivo para las correcciones al sincronizar los dos en el servidor DHCPv4. Estas marcas se enumeran en DHCP_SCAN_FLAG.

[out] ScanList

DHCP_SCAN_LIST estructura que contiene la lista devuelta de direcciones IP de cliente alquiladas que no están sincronizadas.

Valor devuelto

Esta función devuelve ERROR_SUCCESS una llamada correcta. De lo contrario, devuelve uno de los códigos de error de la API de administración del servidor DHCP.

Código devuelto Descripción
ERROR_ACCESS_DENIED
 Esta llamada la realizó un cliente que no es miembro del grupo de seguridad "Administradores DHCP".
ERROR_DHCP_JET_ERROR
 Error al acceder a la base de datos del servidor DHCPv4.
ERROR_DHCP_SUBNET_NOT_PRESENT
 La subred especificada no está definida en el servidor DHCPv4.

Comentarios

Cada dirección IPv4 de cliente DHCPv4 alquilada definida en un servidor DHCPv4 tiene una entrada en un almacén en memoria, que sirve como caché para acelerar la recuperación de concesiones y en la base de datos de concesión de cliente adecuada. DhcpScanDatabase enumera las direcciones IPv4 de cliente DHCPv4 que están presentes en el almacén en memoria y no están presentes en la base de datos, o las que están presentes en la base de datos, pero que no están presentes en el almacén en memoria.

Este proceso es necesario, ya que el servidor DHCPv4 mantiene una caché en memoria de concesiones de cliente a las que se accede con frecuencia para mejorar el rendimiento, pero puede desincronizarse en relación con la base de datos de concesión de cliente persistente del servidor. Por lo tanto, es necesario conciliar los dos almacenes y actualizar la versión en memoria de una dirección IP de concesión de cliente o la dirección IP de concesión de cliente almacenada en la base de datos. La estructura DHCP_SCAN_LIST devuelta por esta operación contiene las concesiones de cliente "definitivas", tal y como especifica la ubicación preferida establecida en el parámetro FixFlag .

Requisitos

   
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2008, Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado dhcpsapi.h
Library Dhcpsapi.lib
Archivo DLL Dhcpsapi.dll

Consulte también

DHCP_SCAN_LIST

  • Last updated on