LPDHCP_NEWPKT fonction de rappel (dhcpssdk.h)

  • Article

La fonction DhcpNewPktHook est appelée par microsoft DHCP Server peu de temps après avoir reçu un paquet DHCP prévu pour traitement. Étant donné que l’appel de fonction DhcpNewPktHook se trouve dans le chemin critique pour le traitement du serveur DHCP Microsoft, cette fonction doit s’exécuter et retourner aussi rapidement que possible, sinon les performances seront affectées.

La fonction DhcpNewPktHook est implémentée par une DLL tierce qui s’inscrit pour la notification d’événements microsoft DHCP Server importants.

Syntaxe

LPDHCP_NEWPKT LpdhcpNewpkt;

DWORD LpdhcpNewpkt(
  [in, out] LPBYTE *Packet,
  [in, out] DWORD *PacketSize,
  [in]      DWORD IpAddress,
  [in]      LPVOID Reserved,
  [in, out] LPVOID *PktContext,
  [out]     LPBOOL ProcessIt
)
{...}

Paramètres

[in, out] Packet

Pointeur vers une mémoire tampon de caractères de 4 Ko qui contient le paquet.

Note Il n’est pas recommandé d’écrire directement dans cette mémoire tampon.
 

[in, out] PacketSize

Pointeur vers la taille du paramètre Packet .

[in] IpAddress

Pointeur vers l’adresse IP du socket sur lequel le paquet a été reçu. L’adresse IP est dans l’ordre de l’hôte.

[in] Reserved

Réservé pour un usage futur.

[in, out] PktContext

Pointeur fourni par la DLL tierce et utilisé par Microsoft DHCP Server dans les références futures à ce paquet spécifique. Les DLL tierces intéressées par ce suivi sont responsables de la fourniture et du suivi de ce contexte de paquets.

[out] ProcessIt

Indicateur indiquant si Microsoft DHCP Server doit continuer à traiter le paquet. Définissez sur TRUE pour indiquer que le traitement doit continuer. Définissez sur FALSE pour que Microsoft DHCP Server supprime le paquet.

Valeur retournée

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

Remarques

Si elles sont utiles, les DLL tierces peuvent modifier la mémoire tampon de paquets ou retourner une nouvelle mémoire tampon de paquets par le biais de la modification appropriée des paramètres Packet et PacketSize .

Si une DLL tierce doit effectuer le suivi d’un paquet donné et de sa progression via microsoft DHCP Server, elle peut fournir un contexte de paquet dans PktContext et utiliser des structures internes qui suivent la progression du paquet dans son traitement DHCP. Un contexte fourni dans PktContext est passé en tant que paramètre à de nombreuses autres fonctions d’API du serveur DHCP, ce qui permet l’identification.

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

DhcpServerCalloutEntry

Fonctionnement de l’API du serveur DHCP