Función DhcpV4SetOptionValues (dhcpsapi.h)

La función DhcpV4SetOptionValues establece códigos de opción y sus valores de datos asociados para un ámbito específico definido en el servidor DHCP. Esta función amplía la funcionalidad proporcionada por DhcpSetOptionValuesV5 al permitir que el autor de la llamada especifique una directiva para las opciones.

Sintaxis

DWORD DHCP_API_FUNCTION DhcpV4SetOptionValues(
  [in, optional] LPWSTR                    ServerIpAddress,
  [in]           DWORD                     Flags,
  [in, optional] LPWSTR                    PolicyName,
  [in, optional] LPWSTR                    VendorName,
  [in]           LPDHCP_OPTION_SCOPE_INFO  ScopeInfo,
  [in]           LPDHCP_OPTION_VALUE_ARRAY OptionValues
);

Parámetros

[in, optional] ServerIpAddress

Puntero a una cadena Unicode terminada en null que representa la dirección IP o el nombre de host del servidor DHCP.

[in] Flags

Reservado. Debe ser 0.

[in, optional] PolicyName

Cadena Unicode terminada en null que representa el nombre de la directiva dentro de la subred del valor de opción que se va a establecer. La subred se identifica mediante el miembro SubnetScopeInfo de ScopeInfo.

[in, optional] VendorName

Cadena Unicode terminada en null que representa al proveedor de la opción. Este parámetro es opcional y, si es NULL, el valor de opción se establece para el proveedor predeterminado.

[in] ScopeInfo

Puntero a una estructura de DHCP_OPTION_SCOPE_INFO que contiene información que describe el ámbito DHCP de los valores de opción que se van a establecer. Este parámetro especifica si el valor de opción se establece para el nivel de ámbito, servidor o predeterminado, o para una reserva IPv4.

[in] OptionValues

Puntero a una estructura DHCP_OPTION_VALUE_ARRAY que contiene una lista de códigos de opción y el valor de datos correspondiente que se establecerá.

Valor devuelto

Si la función se realiza correctamente, devuelve ERROR_SUCCESS.

Si se produce un error en la función, devuelve uno de los siguientes códigos de error o de códigos de error de la API de administración del servidor DHCP.

Valor	Significado
ERROR_INVALID_PARAMETER	Uno o varios de los parámetros no eran válidos.
ERROR_DHCP_SUBNET_NOT_PRESENT	La subred IPv4 especificada no existe.
ERROR_DHCP_CLASS_NOT_FOUND	El nombre de clase que se usa es desconocido o incorrecto.
ERROR_DHCP_POLICY_NOT_FOUND	El nombre de directiva especificado no existe.
ERROR_DHCP_OPTION_NOT_PRESENT	La definición de opción especificada no existe en la base de datos del servidor DHCP.
ERROR_DHCP_NOT_RESERVED_CLIENT	El cliente DHCP especificado no es un cliente reservado.

Comentarios

OptionValues y su miembro, Values, deben ser gratuitos mediante DhcpRpcFreeMemory.

Requisitos

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

Consulte también

DhcpV4GetAllOptionValues

DhcpV4GetOptionValue

DhcpV4RemoveOptionValue

DhcpV4SetOptionValue