DHCP_CALLOUT_TABLE structure (dhcpssdk.h)

Article
02/29/2024

La structure DHCP_CALLOUT_TABLE est utilisée par Microsoft DHCP Server et des DLL tierces pour envoyer des demandes de notification pour les événements du serveur DHCP.

Syntaxe

typedef struct _DHCP_CALLOUT_TABLE {
  LPDHCP_CONTROL        DhcpControlHook;
  LPDHCP_NEWPKT         DhcpNewPktHook;
  LPDHCP_DROP_SEND      DhcpPktDropHook;
  LPDHCP_DROP_SEND      DhcpPktSendHook;
  LPDHCP_PROB           DhcpAddressDelHook;
  LPDHCP_GIVE_ADDRESS   DhcpAddressOfferHook;
  LPDHCP_HANDLE_OPTIONS DhcpHandleOptionsHook;
  LPDHCP_DELETE_CLIENT  DhcpDeleteClientHook;
  LPVOID                DhcpExtensionHook;
  LPVOID                DhcpReservedHook;
} DHCP_CALLOUT_TABLE, *LPDHCP_CALLOUT_TABLE;

Membres

DhcpControlHook

Pointeur vers une fonction DhcpControlHook , implémentée dans une DLL tierce, à appeler lorsque Microsoft DHCP Server est démarré, arrêté, suspendu ou poursuivi. Définissez sur NULL si la notification n’est pas requise.

DhcpNewPktHook

Pointeur vers une fonction DhcpNewPktHook , implémentée dans une DLL tierce, à appeler lorsque Microsoft DHCP Server reçoit un paquet qu’il tente de traiter. Définissez sur NULL si la notification n’est pas requise.

DhcpPktDropHook

Pointeur vers une fonction DhcpPktDropHook , implémentée dans une DLL tierce, à appeler lorsque Microsoft DHCP Server supprime un paquet et lorsqu’un paquet est complètement traité par microsoft DHCP Server. Définissez sur NULL si la notification n’est pas requise.

DhcpPktSendHook

Pointeur vers une fonction DhcpPktSendHook , implémentée dans une DLL tierce, à appeler directement avant que Microsoft DHCP Server envoie une réponse à une demande de client. Définissez sur NULL si la notification n’est pas requise.

DhcpAddressDelHook

Pointeur vers une fonction DhcpAddressDelHook , implémentée dans une DLL tierce, à appeler lorsqu’un événement spécifié dans Microsoft DHCP Server entraîne la suppression d’un paquet. Définissez sur NULL si la notification n’est pas requise.

DhcpAddressOfferHook

Pointeur vers une fonction DhcpAddressOfferHook , implémentée dans une DLL tierce, à appeler directement avant que Microsoft DHCP Server envoie un message DCK DHCP en réponse à un message DE REQUÊTE DHCP. Définissez sur NULL si la notification n’est pas requise.

DhcpHandleOptionsHook

Pointeur vers une fonction DhcpHandleOptionsHook , implémentée dans une DLL tierce, qui envoie uniquement des informations DHCP analysées à la DLL tierce, ce qui permet à la DLL tierce d’éviter de traiter l’intégralité du paquet DHCP. Définissez sur NULL si la notification n’est pas requise.

DhcpDeleteClientHook

Pointeur vers une fonction DhcpDeleteClientHook , implémentée dans une DLL tierce, à appeler directement avant que Microsoft DHCP Server supprime un bail client de sa base de données de baux active. Définissez sur NULL si la notification n’est pas requise.

DhcpExtensionHook

Réservé à un usage ultérieur.

DhcpReservedHook

Réservé à un usage ultérieur.

Remarques

Il n’est pas nécessaire d’implémenter tous les hooks disponibles à partir du serveur DHCP Microsoft. Si la notification d’un événement particulier n’est pas requise, définissez le membre sur NULL. Toutefois, n’oubliez pas que la DLL tierce initialement chargée est responsable du chargement des DLL tierces ultérieures, et que les DLL suivantes peuvent nécessiter la notification d’événements qui, sinon, seraient NULL, ce qui entraînerait un paramètre non NULL pour les membres utilisés par des DLL tierces chaînées qui seraient autrement inutilisées.

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]
En-tête	dhcpssdk.h