Funzione PxeDhcpv6GetOptionValue (wdspxe.h)

Recupera un valore di opzione da un pacchetto DHCPv6.

Sintassi

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

Parametri

[in] pPacket

Puntatore a un pacchetto di risposta allocato con la funzione PxePacketAllocate .

[in] uPacketLen

Lunghezza del pacchetto a cui punta il parametro pReplyPacket .

[in] uInstance

Indice basato su uno che specifica l'istanza del parametro wOption da recuperare.

[in] wOption

Opzione il cui valore verrà recuperato.

[out, optional] pwOptionLen

Indirizzo di WORD che riceverà la lunghezza del valore dell'opzione.

[out, optional] ppOptionValue

Indirizzo di PVOID che riceverà l'indirizzo del valore dell'opzione all'interno del pacchetto.

Valore restituito

I valori restituiti comuni sono elencati nella tabella seguente. Per tutti gli altri errori, viene restituito un codice di errore di Windows appropriato.

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0 (0x0)	L'opzione è stata trovata e un puntatore al valore è stato restituito.
ERROR_FILE_NOT_FOUND 2 (0x2)	L'opzione non si trova.
ERROR_INVALID_DATA 13 (0xD)	Il pacchetto non è un pacchetto DHCPv6 valido. Questo test non è accurato come i test usati dalla funzione PxeDhcpv6IsValid ; vengono verificati solo la lunghezza del pacchetto e il cookie magico.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wdspxe.h
Libreria	WdsPxe.lib
DLL	WdsPxe.dll

Vedi anche

PxeDhcpv6AppendOption

PxeDhcpv6GetVendorOptionValue

PxeDhcpv6IsValid

PxePacketAllocate

Funzioni server di Servizi di distribuzione Windows