Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Überprüft, ob ein Paket ein DHCP-Paket ist.
Syntax
DWORD PXEAPI PxeDhcpIsValid(
[in] PVOID pPacket,
[in] ULONG uPacketLen,
[in] BOOL bRequestPacket,
[out] PBOOL pbPxeOptionPresent
);
Parameter
[in] pPacket
Zeiger auf ein Antwortpaket, das der PxePacketAllocate-Funktion zugeordnet ist.
[in] uPacketLen
Länge des Pakets, auf das der pPacket-Parameter verweist.
[in] bRequestPacket
Gibt an, ob es sich bei dem Paket um ein Anforderungspaket handelt. In der folgenden Tabelle sind die möglichen Werte aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Das zu überprüfende Paket ist ein Anforderungspaket vom Client. |
|
Das zu überprüfende Paket ist ein vom Server generiertes Paket. |
[out] pbPxeOptionPresent
Adresse einer BOOL , die auf TRUE festgelegt ist, wenn das Paket ein gültiges DHCP-Paket ist, das die Option Vendor Class Identifier (60) enthält, wobei der Wert auf "PXEClient" festgelegt ist.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.
Hinweise
Anbieter verwenden diese Funktion, wenn der Filtersatz mit der Funktion PxeProviderSetAttribute festgelegt ist, um alle Pakete zu empfangen, um zu bestimmen, ob ein angegebenes Paket ein gültiges DHCP-Paket ist. Anbieter können diese Funktion auch verwenden, um Antwortpakete zu überprüfen. In der Regel erfolgt dies nur für Debug- oder Testbuilds des Anbieters.
Die Validierungstests umfassen die folgenden Tests.
| DHCP-Feld | Initialisierter Wert |
|---|---|
| Vorgang (op) | Wenn der bClientRequest-ParameterTRUE ist, muss dieses Feld 1 (BOOTP-Anforderung) sein, andernfalls muss dieses Feld 2 (BOOTP Reply) sein. |
| Länge der Hardwareadresse (hlen) | Muss kleiner oder gleich 16 sein. |
| Hostname (sname) | Muss NULL beendet sein. |
| Name der Startdatei (Datei) | Muss NULL beendet sein. |
| Magic Cookie (erste 4 Oktette des Verkaufs) | Muss gültiges DHCP Magic Cookie (99 130 83 99) enthalten. |
| Optionslänge | Alle Optionen müssen eine gültige Länge aufweisen und das Paket nicht überlaufen. |
| DHCP-Nachrichtentyp (53) | Muss vorhanden sein. |
| Endoption (255) | Das Paket muss mit der DHCP-Endoption enden. Aufgrund der mindesten Paketlänge kann das Paket größer sein, aber keine Optionen können der Endoption folgen. |
Anforderungen
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2008, Windows Server 2003 mit SP2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wdspxe.h |
| Bibliothek | WdsPxe.lib |
| DLL | WdsPxe.dll |