Compartilhar via


Função PxeDhcpInitialize (wdspxe.h)

Inicializa um pacote de resposta como um pacote de resposta DHCP.

Sintaxe

DWORD PXEAPI PxeDhcpInitialize(
  [in]      PVOID  pRecvPacket,
  [in]      ULONG  uRecvPacketLen,
  [in, out] PVOID  pReplyPacket,
  [in]      ULONG  uMaxReplyPacketLen,
  [out]     PULONG puReplyPacketLen
);

Parâmetros

[in] pRecvPacket

Endereço de um pacote DHCP válido recebido do cliente no retorno de chamada PxeProviderRecvRequest .

[in] uRecvPacketLen

Comprimento do pacote apontado pelo parâmetro pRecvPacket .

[in, out] pReplyPacket

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

[in] uMaxReplyPacketLen

Comprimento alocado do pacote apontado pelo parâmetro pReplyPacket .

[out] puReplyPacketLen

Endereço de um ULONG que, após a conclusão bem-sucedida, receberá o comprimento do pacote apontado pelo parâmetro pReplyPacket .

Retornar valor

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.

Comentários

Os provedores usam essa função para inicializar um pacote de resposta com base no pacote recebido do cliente. O pacote de resposta é inicializado da seguinte maneira.

Campo DHCP Valor inicializado
Operação (op) 2 (Resposta BOOTP)
Tipo de endereço de hardware (htype) Copiado de pRecvPacket
Comprimento do endereço de hardware (hlen) Copiado de pRecvPacket
Endereço de hardware (chaddr) Copiado de pRecvPacket
ID da transação (xid) Copiado de pRecvPacket
Segundos desde a inicialização (ss) Copiado de pRecvPacket
Endereço IP do cliente (ciaddr) Copiado de pRecvPacket
Seu endereço IP (yiaddr) Copiado de pRecvPacket
Endereço IP do servidor (siaddr) Copiado de pRecvPacket
Endereço IP do Agente de Retransmissão (giaddr) Copiado de pRecvPacket
Magic Cookie (primeiros 4 octetos de vend) Copiado de pRecvPacket
 

Todos os outros campos são inicializados como zero.

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

PxePacketAllocate

PxeProviderRecvRequest

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