Função PxeDhcpGetVendorOptionValue (wdspxe.h)

Artigo
03/09/2024

Recupera um valor de opção do campo Informações Específicas do Fornecedor (43) de um pacote DHCP.

Sintaxe

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

Opção cujo valor será recuperado.

[in] uInstance

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

[out, optional] pbOptionLen

Endereço de BYTE 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 PxeDhcpIsValid ; somente o comprimento do pacote e o cookie mágico são verificados.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2008, Windows Server 2003 com SP2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wdspxe.h
Biblioteca	WdsPxe.lib
DLL	WdsPxe.dll

Confira também

PxeDhcpGetOptionValue

PxePacketAllocate

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

Share via