Función DhcpGetAllOptions (dhcpsapi.h)

La función DhcpGetAllOptions devuelve una matriz que contiene todas las opciones definidas en el servidor DHCP.

Sintaxis

DWORD DhcpGetAllOptions(
  [in]  LPWSTR             ServerIpAddress,
  [in]  DWORD              Flags,
  [out] LPDHCP_ALL_OPTIONS *OptionStruct
);

Parámetros

[in] ServerIpAddress

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

[in] Flags

Especifica una marca de bits que indica si las opciones son específicas del proveedor o no. Si la calificación de las opciones de proveedor no es necesaria, este parámetro debe ser 0.

Valor	Significado
DHCP_FLAGS_OPTION_IS_VENDOR	Esta marca debe establecerse si se desean opciones específicas del proveedor.

[out] OptionStruct

Puntero a una estructura de DHCP_ALL_OPTIONS que contiene todas las opciones definidas para un proveedor o una clase predeterminada. Si no hay opciones disponibles en el servidor, este valor será NULL.

Nota  

La memoria de este parámetro debe ser libre mediante DhcpRpcFreeMemory.

 

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_DHCP_JET_ERROR	Error al acceder a la base de datos del servidor DHCP.

Comentarios

Habrá un elemento de opción en la matriz especificada por OptionStruct para cada par de proveedor o clase definido en el servidor DHCP.

Requisitos

Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	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

DhcpGetAllOptionValues