Compartir a través de


Función PxeDhcpGetOptionValue (wdspxe.h)

Recupera un valor de opción de un paquete DHCP.

Sintaxis

DWORD PXEAPI PxeDhcpGetOptionValue(
  [in]            PVOID pPacket,
  [in]            ULONG uPacketLen,
  [in]            ULONG uInstance,
  [in]            BYTE  bOption,
  [out, optional] PBYTE pbOptionLen,
  [out, optional] PVOID *ppOptionValue
);

Parámetros

[in] pPacket

Puntero a un paquete de respuesta asignado con la función PxePacketAllocate .

[in] uPacketLen

Longitud del paquete al que apunta el parámetro pReplyPacket .

[in] uInstance

Índice basado en uno que especifica la instancia del parámetro bOption que se va a recuperar.

[in] bOption

Opción cuyo valor se recuperará.

[out, optional] pbOptionLen

Dirección de BYTE que recibirá la longitud del valor de la opción.

[out, optional] ppOptionValue

Dirección de PVOID que recibirá la dirección del valor de opción dentro del paquete.

Valor devuelto

Los valores devueltos comunes se enumeran en la tabla siguiente. Para todos los demás errores, se devuelve un código de error de Windows adecuado.

Código o valor devuelto Descripción
ERROR_SUCCESS
0 (0x0)
Se encontró la opción y se devolvió un puntero al valor.
ERROR_FILE_NOT_FOUND
2 (0x2)
La opción no se encuentra.
ERROR_INVALID_DATA
13 (0xD)
El paquete no es un paquete DHCP válido. Esta prueba no es tan exhaustiva como las pruebas usadas por la función PxeDhcpIsValid ; solo se comprueban la longitud del paquete y la cookie mágica.

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2008, Windows Server 2003 con SP2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wdspxe.h
Library WdsPxe.lib
Archivo DLL WdsPxe.dll

Consulte también

PxeDhcpAppendOption

PxeDhcpGetVendorOptionValue

PxePacketAllocate

Funciones del servidor de Servicios de implementación de Windows