Funzione PxeDhcpv6GetVendorOptionValue (wdspxe.h)

Articolo
03/13/2024

Recupera i valori delle opzioni dal campo OPTION_VENDOR_OPTS (17) di un pacchetto DHCPv6.

Sintassi

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
);

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] dwEnterpriseNumber

Numero organizzazione assegnato al fornitore dell'opzione dall'autorità IANA (Internet Assigned Numbers Authority).

Per altre informazioni sui numeri aziendali assegnati, gli sviluppatori devono fare riferimento al Protocollo di configurazione host dinamico per IPv6 (RFC 3315) gestito da Internet Engineering Task Force (IETF).

[in] wOption

Opzione il cui valore verrà recuperato.

[in] uInstance

Indice in base uno che specifica l'istanza del parametro wOption da recuperare.

[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)	È stata trovata l'opzione e è stato restituito un puntatore al valore.
ERROR_FILE_NOT_FOUND 2 (0x2)	L'opzione non è stata individuata.
ERROR_INVALID_DATA 13 (0xD)	Il pacchetto non è un pacchetto DHCP valido. Questo test non è accurato come i test usati dalla funzione PxeDhcpv6IsValid ; vengono verificati solo la lunghezza del pacchetto e il cookie magic.

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

PxeDhcpv6GetOptionValue

PxePacketAllocate

Funzioni del server di Servizi di distribuzione Windows

Condividi tramite