PxeDhcpGetOptionValue-Funktion (wdspxe.h)

Artikel
08/27/2023

Ruft einen Optionswert aus einem DHCP-Paket ab.

Syntax

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

Parameter

[in] pPacket

Zeiger auf ein Antwortpaket, das der PxePacketAllocate-Funktion zugeordnet ist.

[in] uPacketLen

Länge des Pakets, auf das der pReplyPacket-Parameter verweist.

[in] uInstance

Ein basierter Index, der angibt, welche instance des bOption-Parameters abgerufen werden sollen.

[in] bOption

Option, deren Wert abgerufen wird.

[out, optional] pbOptionLen

Adresse von BYTE , die die Länge des Optionswerts erhält.

[out, optional] ppOptionValue

Adresse von PVOID , die die Adresse des Optionswerts innerhalb des Pakets empfängt.

Rückgabewert

Allgemeine Rückgabewerte sind in der folgenden Tabelle aufgeführt. Für alle anderen Fehler wird ein entsprechender Windows-Fehlercode zurückgegeben.

Rückgabecode/-wert	BESCHREIBUNG
ERROR_SUCCESS 0 (0x0)	Die Option wurde gefunden, und ein Zeiger auf den Wert wurde zurückgegeben.
ERROR_FILE_NOT_FOUND 2 (0x2)	Die Option wurde nicht gefunden.
ERROR_INVALID_DATA 13 (0xD)	Das Paket ist kein gültiges DHCP-Paket. Dieser Test ist nicht so gründlich wie die Tests, die von der PxeDhcpIsValid-Funktion verwendet werden. nur die Paketlänge und das Magic Cookie werden überprüft.

Anforderungen

Anforderung	Wert
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

Weitere Informationen

PxeDhcpAppendOption

PxeDhcpGetVendorOptionValue

PxePacketAllocate

Serverfunktionen der Windows-Bereitstellungsdienste

Freigeben über