LPDHCP_ENTRY_POINT_FUNC fonction de rappel (dhcpssdk.h)

  • Article

La fonction DhcpServerCalloutEntry est appelée par Microsoft DHCP Server pour initialiser une DLL tierce et pour découvrir les événements pour lesquels la DLL tierce souhaite la notification. La fonction DhcpServerCalloutEntry est implémentée par des DLL tierces.

Syntaxe

LPDHCP_ENTRY_POINT_FUNC LpdhcpEntryPointFunc;

DWORD LpdhcpEntryPointFunc(
  [in]  LPWSTR ChainDlls,
  [in]  DWORD CalloutVersion,
  [out] LPDHCP_CALLOUT_TABLE CalloutTbl
)
{...}

Paramètres

[in] ChainDlls

Collection des DLL tierces restantes qui fournissaient des entrées de Registre demandant la notification d’événements de serveur DHCP, au format REG_MULTI_SZ.

[in] CalloutVersion

Version de l’API de serveur DHCP que la DLL tierce est censée prendre en charge. Le numéro de version actuel est zéro.

[out] CalloutTbl

Ensemble cumulatif de hooks de notification demandés par toutes les DLL tierces, sous la forme d’une structure de DHCP_CALLOUT_TABLE .

Valeur retournée

Les valeurs de retour sont définies par l’application qui fournit le rappel.

Remarques

Une fois le chargement réussi d’une DLL tierce, Microsoft DHCP Server appelle la fonction DhcpServerCalloutEntry de la DLL. Si cet appel de fonction réussit, Microsoft DHCP Server ne tente pas de charger d’autres DLL tierces et transmet plutôt la liste des DLL tierces restantes dans le paramètre ChainDlls . Il incombe à la DLL tierce chargée de s’assurer que :

  • d’autres DLL tierces sont chargées
  • leur fonction DhcpServerCalloutEntry appelée
  • la liste fusionnée des points d’entrée de notification demandés est retournée à Microsoft DHCP Server dans le paramètre CalloutTbl .
La DLL tierce initialement chargée est responsable de la gestion d’une table de points d’entrée de notification cumulés et, lors de la notification d’un événement particulier, doit appeler toutes les DLL tierces chaînées avant de revenir à Microsoft DHCP Server.
Note Pour la négociation de version, Microsoft DHCP Server peut appeler la fonction DhcpServerCalloutEntry jusqu’à ce qu’une version compatible soit trouvée.
 

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

Chaînage de plusieurs DLL tierces

DHCP_CALLOUT_TABLE

Types de valeurs de Registre