LPDHCP_PROB fonction de rappel (dhcpssdk.h)

  • Article

La fonction DhcpAddressDelHook est appelée par microsoft DHCP Server lorsque l’un des quatre événements définis suivants se produit :

  • DHCP_PROB_CONFLICT
  • DHCP_PROB_DECLINE
  • DHCP_PROB_RELEASE
  • DHCP_PROB_NACKED
Pour plus d’informations sur ces événements, consultez Notes. La fonction DhcpAddressDelHook est implémentée par une DLL tierce qui s’inscrit pour la notification d’événements microsoft DHCP Server importants. La fonction DhcpAddressDelHook ne doit pas se bloquer.

Syntaxe

LPDHCP_PROB LpdhcpProb;

DWORD LpdhcpProb(
  [in] LPBYTE Packet,
  [in] DWORD PacketSize,
  [in] DWORD ControlCode,
  [in] DWORD IpAddress,
  [in] DWORD AltAddress,
  [in] LPVOID Reserved,
  [in] LPVOID PktContext
)
{...}

Paramètres

[in] Packet

Mémoire tampon pour le paquet en cours de traitement.

[in] PacketSize

Taille du paramètre Packet , en octets.

[in] ControlCode

Spécifie l’événement. Consultez Remarques pour les définitions de code de contrôle.

[in] IpAddress

Adresse IP (Internet Protocol) du socket sur lequel le paquet a été reçu. L’adresse IP est dans l’ordre de l’hôte.

[in] AltAddress

Adresse IP (Internet Protocol) utilisée pour fournir des informations supplémentaires sur l’événement. La signification de AltAddress varie en fonction de la valeur de ControlCode. Consultez la section Notes.

[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.

Valeur retournée

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

Remarques

Le tableau suivant définit les quatre événements définis qui déclenchent microsoft DHCP Server pour appeler la fonction DhcpAddressDelHook dans une DLL tierce.

Code de contrôle Description
DHCP_PROB_CONFLICT L’adresse tentée d’être proposée, comme indiqué dans AltAddress, est déjà utilisée sur le réseau.
DHCP_PROB_DECLINE Le paquet était un message DECLINE pour l’adresse spécifiée dans AltAddress.
DHCP_PROB_RELEASE Le paquet était un message RELEASE pour l’adresse spécifiée dans AltAddress.
DHCP_PROB_NACKED Le paquet était un message REQUEST pour l’adresse spécifiée dans AltAddress, et la demande a été refusée par Microsoft DHCP Server.

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

DhcpNewPktHook