Função PxeDhcpv6GetVendorOptionValue (wdspxe.h)

Artigo
03/03/2024

Recupera valores de opção do campo OPTION_VENDOR_OPTS (17) de um pacote DHCPv6.

Sintaxe

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

Parâmetros

[in] pPacket

Ponteiro para um pacote de resposta alocado com a função PxePacketAllocate .

[in] uPacketLen

Comprimento do pacote apontado pelo parâmetro pReplyPacket .

[in] dwEnterpriseNumber

Um Número da Empresa atribuído ao fornecedor da opção pela IANA (Internet Assigned Numbers Authority).

Para obter mais informações sobre números da empresa atribuídos, os desenvolvedores devem consultar o Protocolo de Configuração de Host Dinâmico para IPv6 (RFC 3315) mantido pela IETF (Internet Engineering Task Force).

[in] wOption

Opção cujo valor será recuperado.

[in] uInstance

Índice baseado em um que especifica qual instância do parâmetro wOption recuperar.

[out, optional] pwOptionLen

Endereço do WORD que receberá o comprimento do valor da opção.

[out, optional] ppOptionValue

Endereço de PVOID que receberá o endereço do valor da opção dentro do pacote.

Retornar valor

Os valores retornados comuns são listados na tabela a seguir. Para todas as outras falhas, um código de erro apropriado do Windows é retornado.

Valor/código retornado	Descrição
ERROR_SUCCESS 0 (0x0)	A opção foi encontrada e um ponteiro para o valor foi retornado.
ERROR_FILE_NOT_FOUND 2 (0x2)	A opção não estava localizada.
ERROR_INVALID_DATA 13 (0xD)	O pacote não é um pacote DHCP válido. Esse teste não é tão completo quanto os testes usados pela função PxeDhcpv6IsValid ; somente o comprimento do pacote e o cookie mágico são verificados.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wdspxe.h
Biblioteca	WdsPxe.lib
DLL	WdsPxe.dll

Confira também

PxeDhcpv6GetOptionValue

PxePacketAllocate

Funções de servidor dos Serviços de Implantação do Windows

Compartilhar via