Función PxeDhcpIsValid (wdspxe.h)

Valida que un paquete es un paquete DHCP.

Sintaxis

DWORD PXEAPI PxeDhcpIsValid(
  [in]  PVOID pPacket,
  [in]  ULONG uPacketLen,
  [in]  BOOL  bRequestPacket,
  [out] PBOOL pbPxeOptionPresent
);

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 pPacket .

[in] bRequestPacket

Indica si el paquete es un paquete de solicitud. En la tabla siguiente se enumeran los valores posibles.

Valor	Significado
TRUE 1	El paquete que se va a validar es un paquete de solicitud del cliente.
FALSE 0	El paquete que se va a validar es un paquete generado por el servidor.

[out] pbPxeOptionPresent

Dirección de un BOOL que se establece en TRUE si el paquete es un paquete DHCP válido que contiene la opción Identificador de clase de proveedor (60) con el valor establecido en "PXEClient".

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se ERROR_SUCCESS.

Comentarios

Los proveedores usan esta función cuando el conjunto de filtros con la función PxeProviderSetAttribute se establece para recibir todos los paquetes para determinar si un paquete especificado es un paquete DHCP válido. Los proveedores también pueden usar esta función para validar los paquetes de respuesta; Normalmente, esto solo se realiza para las compilaciones de depuración o prueba del proveedor.

Las pruebas de validación incluyen las siguientes pruebas.

Campo DHCP	Valor inicializado
Operación (op)	Si el parámetro bClientRequest es TRUE, este campo debe ser 1 (solicitud BOOTP), de lo contrario, este campo debe ser 2 (respuesta de BOOTP).
Longitud de la dirección de hardware (hlen)	Debe ser menor o igual que 16.
Nombre de host (sname)	Debe finalizar NULL .
Nombre del archivo de arranque (archivo)	Debe finalizar NULL .
Magic Cookie (primeros 4 octetos de vend)	Debe contener cookies mágicas DHCP válidas (99 130 83 99).
Longitud de la opción	Todas las opciones deben tener una longitud válida y no saturar el paquete.
Tipo de mensaje DHCP (53)	Debe estar presente.
End Option (255)	El paquete debe terminar con la opción de extremo DHCP. Debido a las longitudes mínimas de los paquetes, el paquete puede ser mayor, pero ninguna opción puede seguir la opción end.

Requisitos

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

PxePacketAllocate

PxeProviderSetAttribute

Funciones del servidor de Servicios de implementación de Windows