Función DhcpV4SetOptionValue (dhcpsapi.h)

La función DhcpV4SetOptionValue establece información para un valor de opción específico en el servidor DHCP. Esta función amplía la funcionalidad proporcionada por DhcpSetOptionValueV5 al permitir que el autor de la llamada especifique una directiva para la opción .

Sintaxis

DWORD DHCP_API_FUNCTION DhcpV4SetOptionValue(
  [in, optional] LPWSTR                   ServerIpAddress,
  [in]           DWORD                    Flags,
  [in]           DHCP_OPTION_ID           OptionId,
  [in, optional] LPWSTR                   PolicyName,
  [in, optional] LPWSTR                   VendorName,
  [in]           LPDHCP_OPTION_SCOPE_INFO ScopeInfo,
  [in]           LPDHCP_OPTION_DATA       OptionValue
);

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

Indica si la opción es para un proveedor específico o predeterminado.

Marcas	Significado
0x00000000	El valor de opción se recupera para un proveedor predeterminado.
DHCP_FLAGS_OPTION_IS_VENDOR 0x00000003	El valor de opción se recupera para un proveedor específico. El proveedor está en VendorName.

[in] OptionId

DHCP_OPTION_ID estructura que especifica el código de opción único para el valor de opción que se va a recuperar. Puede encontrar una lista completa de los códigos de opción DHCP y BOOTP estándar en . http://www.ietf.org/rfc/rfc2132.txt

[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 debe ser NULL cuando las marcas no se DHCP_FLAGS_OPTION_IS_VENDOR. Si no se especifica el proveedor, 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 sobre el ámbito del valor de opción que se va a establecer.

[in] OptionValue

Puntero a una estructura DHCP_OPTION_DATA que contiene el valor de datos correspondiente al código de opción DHCP especificado por OptionID.

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.

Requisitos

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

DhcpV4SetOptionValues