LPDHCP_HANDLE_OPTIONS fonction de rappel (dhcpssdk.h)

  • Article

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

Voir aussi

DHCP_CALLOUT_TABLE

DHCP_SERVER_OPTIONS

DhcpNewPktHook