PxeDhcpGetVendorOptionValue-Funktion (wdspxe.h)

Artikel
03/09/2024

Ruft einen Optionswert aus dem Feld Anbieterspezifische Informationen (43) eines DHCP-Pakets ab.

Syntax

DWORD PXEAPI PxeDhcpGetVendorOptionValue(
  [in]            PVOID pPacket,
  [in]            ULONG uPacketLen,
  [in]            BYTE  bOption,
  [in]            ULONG uInstance,
  [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] bOption

Option, deren Wert abgerufen wird.

[in] uInstance

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

[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

PxeDhcpGetOptionValue

PxePacketAllocate

Serverfunktionen der Windows-Bereitstellungsdienste

Freigeben über