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 |