structure DHCP_CLIENT_INFO_PB (dhcpsapi.h)

La structure DHCP_CLIENT_INFO_PB définit des informations sur un client DHCPv4, y compris les informations de filtre status et toutes les stratégies qui ont entraîné l’attribution d’adresse IPv4.

Syntaxe

typedef struct _DHCP_CLIENT_INFO_PB {
  DHCP_IP_ADDRESS  ClientIpAddress;
  DHCP_IP_MASK     SubnetMask;
  DHCP_CLIENT_UID  ClientHardwareAddress;
  LPWSTR           ClientName;
  LPWSTR           ClientComment;
  DATE_TIME        ClientLeaseExpires;
  DHCP_HOST_INFO   OwnerHost;
  BYTE             bClientType;
  BYTE             AddressState;
  QuarantineStatus Status;
  DATE_TIME        ProbationEnds;
  BOOL             QuarantineCapable;
  DWORD            FilterStatus;
  LPWSTR           PolicyName;
} DHCP_CLIENT_INFO_PB, *LPDHCP_CLIENT_INFO_PB;

Membres

ClientIpAddress

DHCP_IP_ADDRESS structure qui contient l’adresse IPv4 du client DHCPv4.

SubnetMask

DHCP IP_MASK structure qui contient le masque de sous-réseau IPv4 du client DHCPv4.

ClientHardwareAddress

DHCP_CLIENT_UID structure qui contient l’adresse matérielle (adresse MAC) du client DHCPv4.

ClientName

Pointeur vers une chaîne Unicode terminée par null qui représente le nom de l’ordinateur client DHCPv4.

ClientComment

Pointeur vers une chaîne Unicode terminée par null qui représente la description du client DHCPv4.

ClientLeaseExpires

DATE_TIME structure qui contient l’heure d’expiration du bail pour le client DHCPv4. Il s’agit de l’heure UTC représentée au format FILETIME .

OwnerHost

DHCP_HOST_INFO structure qui contient des informations sur l’ordinateur hôte (machine serveur DHCPv4) qui a fourni un bail au client DHCPv4.

bClientType

Valeur qui spécifie le type de client DHCPv4. Les valeurs possibles sont les suivantes :

Valeur	Signification
CLIENT_TYPE_UNSPECIFIED 0x00	Le client DHCPv4 n’est pas défini dans la base de données du serveur.
CLIENT_TYPE_DHCP 0x01	Le client DHCPv4 prend en charge le protocole DHCP.
CLIENT_TYPE_BOOTP 0x02	Le client DHCPv4 prend en charge le protocole BOOTP.
CLIENT_TYPE_BOTH 0x03	Le client DHCPv4 prend en charge les protocoles DHCPv4 et BOOTP
CLIENT_TYPE_RESERVATION_FLAG 0x04	Une réservation IPv4 est créée pour le client DHCPv4.
CLIENT_TYPE_NONE 0x64	Compatibilité descendante pour l’adressage manuel.

AddressState

Valeur qui spécifie différents états de l’adresse IPv4. Les valeurs possibles sont les suivantes :

Valeur	Signification
ADDRESS_STATE_OFFERED 0x0	Cette adresse IPv4 est proposée au client DHCPv4.
ADDRESS_STATE_ACTIVE 0x1	L’adresse IPv4 est active et possède un enregistrement de bail client DHCPv4 actif.
ADDRESS_STATE_DECLINED 0x2	La demande d’adresse IPv4 est refusée par le client DHCPv4 ; par conséquent, il s’agit d’une adresse IPv4 incorrecte.
ADDRESS_STATE_DOOM 0x3	L’adresse IPv4 est à l’état DOOMED et doit être supprimée.

Status

Énumération QuarantineStatus qui spécifie les valeurs d’intégrité possibles status pour le client DHCPv4, telles que validées sur le serveur NAP.

ProbationEnds

DATE_TIME structure qui contient l’heure de fin de la probation si le client DHCPv4 est en probation. Le client DHCPv4 dispose d’un accès complet au réseau pendant cette période. Il s’agit de l’heure UTC représentée au format FILETIME .

QuarantineCapable

TRUE, si le client DHCPv4 est activé pour la mise en quarantaine ; Sinon, il est FALSE.

FilterStatus

Valeur d’indicateur entier qui spécifie le status du filtre de couche de liens.

Valeur	Signification
FILTER_STATUS_NONE 0x00000001	L’adresse MAC du client DHCPv4 ne correspond à aucun filtre.
FILTER_STATUS_FULL_MATCH_IN_ALLOW_LIST 0x00000002	L’adresse MAC du client DHCv4P correspond entièrement à un filtre de liste verte.
FILTER_STATUS_FULL_MATCH_IN_DENY_LIST 0x00000004	L’adresse MAC du client DHCPv4 correspond entièrement à un filtre de liste de refus.
FILTER_STATUS_WILDCARD_MATCH_IN_ALLOW_LIST 0x00000008	L’adresse MAC du client DHCPv4 a une correspondance de carte générique dans la liste verte.
FILTER_STATUS_WILDCARD_MATCH_IN_DENY_LIST 0x00000010	L’adresse MAC du client DHCPv4 a une correspondance de carte générique dans la liste de refus.

PolicyName

Pointeur vers une chaîne Unicode terminée par null qui représente le nom de stratégie de serveur DHCP qui a entraîné l’attribution d’adresse IPv4 au client DHCPv4 dans le bail.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
En-tête	dhcpsapi.h

Voir aussi

DHCP_CLIENT_INFO_PB_ARRAY

DhcpV4CreateClientInfo

DhcpV4GetClientInfo