Freigeben über


PxeDhcpv6GetOptionValue-Funktion (wdspxe.h)

Ruft einen Optionswert aus einem DHCPv6-Paket ab.

Syntax

DWORD PXEAPI PxeDhcpv6GetOptionValue(
  [in]            PVOID pPacket,
  [in]            ULONG uPacketLen,
  [in]            ULONG uInstance,
  [in]            WORD  wOption,
  [out, optional] PWORD pwOptionLen,
  [out, optional] PVOID *ppOptionValue
);

Parameter

[in] pPacket

Zeiger auf ein Antwortpaket, das mit 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 wOption-Parameters abgerufen werden soll.

[in] wOption

Option, deren Wert abgerufen wird.

[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 DHCPv6-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

PxeDhcpv6AppendOption

PxeDhcpv6GetVendorOptionValue

PxeDhcpv6IsValid

PxePacketAllocate

Serverfunktionen der Windows-Bereitstellungsdienste