Funzione PxeDhcpInitialize (wdspxe.h)
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 |