Funzione PxeDhcpGetOptionValue (wdspxe.h)

Articolo
08/27/2023

Recupera un valore di opzione da un pacchetto DHCP.

Sintassi

DWORD PXEAPI PxeDhcpGetOptionValue(
  [in]            PVOID pPacket,
  [in]            ULONG uPacketLen,
  [in]            ULONG uInstance,
  [in]            BYTE  bOption,
  [out, optional] PBYTE pbOptionLen,
  [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 bOption da recuperare.

[in] bOption

Opzione il cui valore verrà recuperato.

[out, optional] pbOptionLen

Indirizzo di BYTE 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 DHCP valido. Questo test non è approfondito come i test usati dalla funzione PxeDhcpIsValid ; vengono verificati solo la lunghezza del pacchetto e il cookie magico.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008, Windows Server 2003 con SP2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wdspxe.h
Libreria	WdsPxe.lib
DLL	WdsPxe.dll

Vedi anche

PxeDhcpAppendOption

PxeDhcpGetVendorOptionValue

PxePacketAllocate

Funzioni server di Servizi di distribuzione Windows