PxeDhcpv6GetVendorOptionValue-Funktion (wdspxe.h)

Artikel
03/06/2024

Ruft Optionswerte aus dem feld OPTION_VENDOR_OPTS (17) eines DHCPv6-Pakets ab.

Syntax

DWORD PXEAPI PxeDhcpv6GetVendorOptionValue(
  [in]            PVOID pPacket,
  [in]            ULONG uPacketLen,
  [in]            DWORD dwEnterpriseNumber,
  [in]            WORD  wOption,
  [in]            ULONG uInstance,
  [out, optional] PWORD pwOptionLen,
  [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] dwEnterpriseNumber

Eine Unternehmensnummer, die dem Anbieter der Option von der Internet Assigned Numbers Authority (IANA) zugewiesen ist.

Weitere Informationen zu zugewiesenen Unternehmensnummern finden Entwickler im Dynamic Host Configuration Protocol for IPv6 (RFC 3315), das von der Internet Engineering Task Force (IETF) verwaltet wird.

[in] wOption

Option, deren Wert abgerufen wird.

[in] uInstance

Ein basierter Index, der angibt, welche instance des wOption-Parameters abgerufen werden soll.

[out, optional] pwOptionLen

Adresse von WORD , 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 PxeDhcpv6IsValid-Funktion verwendet werden. nur die Paketlänge und das Magic Cookie werden überprüft.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wdspxe.h
Bibliothek	WdsPxe.lib
DLL	WdsPxe.dll

Weitere Informationen

PxeDhcpv6GetOptionValue

PxePacketAllocate

Serverfunktionen der Windows-Bereitstellungsdienste

Freigeben über