LPDHCP_HANDLE_OPTIONS fonction de rappel (dhcpssdk.h)
La fonction DhcpHandleOptionsHook permet aux DLL tierces d’obtenir des options couramment utilisées à partir d’un paquet DHCP, ce qui évite d’avoir à traiter l’intégralité du paquet DHCP. La fonction DhcpHandleOptionsHook ne doit pas se bloquer.
Syntaxe
LPDHCP_HANDLE_OPTIONS LpdhcpHandleOptions;
DWORD LpdhcpHandleOptions(
[in] LPBYTE Packet,
[in] DWORD PacketSize,
[in] LPVOID Reserved,
[in] LPVOID PktContext,
[in, out] LPDHCP_SERVER_OPTIONS ServerOptions
)
{...}
Paramètres
[in] Packet
Mémoire tampon pour le paquet en cours de traitement.
[in] PacketSize
Taille du paramètre Packet , en octets.
[in] Reserved
Réservez pour une utilisation ultérieure.
[in] PktContext
Contexte identifiant le paquet, comme indiqué dans le paramètre PktContext d’un appel de fonction DhcpNewPktHook précédent.
[in, out] ServerOptions
Structure de type DHCP_SERVER_OPTIONS contenant les informations analysées à partir du paquet par microsoft DHCP Server et fournies en tant que collection d’options de serveur couramment utilisées.
Valeur retournée
Les valeurs de retour sont définies par l’application qui fournit le rappel.
Remarques
La fonction DhcpHandleOptionsHook est utile lorsque les développeurs de DLL tierces souhaitent éviter d’avoir à traiter l’intégralité d’un paquet DHCP et peuvent plutôt obtenir les résultats souhaités par un ensemble d’options de serveur couramment utilisées. Lorsque des DLL tierces s’inscrivent pour cette notification d’événement, le serveur Microsoft DHCP analyse le paquet entrant, extrait les options de serveur couramment utilisées et les transmet à la DLL tierce dans le paramètre ServerOptions .
Si la structure DHCP_SERVER_OPTIONS pointée dans ServerOptions est nécessaire au-delà de l’achèvement de l’appel de fonction DhcpHandleOptionsHook , les DLL tierces doivent effectuer une copie de la structure.
La fonction DhcpHandleOptionsHook peut être appelée plusieurs fois pour un seul paquet.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Aucun pris en charge |
Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | dhcpssdk.h |