Funzione PxeDhcpInitialize (wdspxe.h)

  • Articolo

Inizializza un pacchetto di risposta come pacchetto di risposta DHCP.

Sintassi

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

Parametri

[in] pRecvPacket

Indirizzo di un pacchetto DHCP valido ricevuto dal client nel callback PxeProviderRecvRequest .

[in] uRecvPacketLen

Lunghezza del pacchetto a cui punta il parametro pRecvPacket .

[in, out] pReplyPacket

Puntatore a un pacchetto di risposta allocato con la funzione PxePacketAllocate .

[in] uMaxReplyPacketLen

Lunghezza allocata del pacchetto a cui punta il parametro pReplyPacket .

[out] puReplyPacketLen

Indirizzo di un ULONG che al termine del completamento riceverà la lunghezza del pacchetto a cui punta il parametro pReplyPacket .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Commenti

I provider usano questa funzione per inizializzare un pacchetto di risposta in base al pacchetto ricevuto dal client. Il pacchetto di risposta viene inizializzato come indicato di seguito.

Campo DHCP Valore inizializzato
Operazione (op) 2 (risposta BOOTP)
Tipo di indirizzo hardware (htype) Copiato da pRecvPacket
Lunghezza dell'indirizzo hardware (hlen) Copiato da pRecvPacket
Indirizzo hardware (chaddr) Copiato da pRecvPacket
ID transazione (xid) Copiato da pRecvPacket
Secondi dall'avvio (sec) Copiato da pRecvPacket
Indirizzo IP client (ciaddr) Copiato da pRecvPacket
Indirizzo IP (yiaddr) Copiato da pRecvPacket
Indirizzo IP del server (siaddr) Copiato da pRecvPacket
Indirizzo IP dell'agente di inoltro (giaddr) Copiato da pRecvPacket
Magic Cookie (primi 4 ottetti di vend) Copiato da pRecvPacket
 

Tutti gli altri campi vengono inizializzati su zero.

Requisiti

Requisito Valore
Client minimo supportato Nessuno supportato
Server minimo supportato Windows Server 2008, Windows Server 2003 con SP2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wdspxe.h
Libreria WdsPxe.lib
DLL WdsPxe.dll

Vedi anche

PxePacketAllocate

PxeProviderRecvRequest

Funzioni server di Servizi di distribuzione Windows