DHCP_CLIENT_FILTER_STATUS_INFO structure (dhcpsapi.h)

La structure DHCP_CLIENT_FILTER_STATUS_INFO définit des informations sur le client DHCPv4, y compris des informations de filtre status.

Syntaxe

typedef struct _DHCP_CLIENT_FILTER_STATUS_INFO {
  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;
} DHCP_CLIENT_FILTER_STATUS_INFO, *LPDHCP_CLIENT_FILTER_STATUS_INFO;

Membres

ClientIpAddress

DHCP_IP_ADDRESS valeur de type qui contient l’adresse IPv4 du client DHCPv4.

SubnetMask

DHCP IP_MASK valeur de type qui contient l’adresse du masque de sous-réseau IPv4 du client DHCPv4.

ClientHardwareAddress

Valeur GUID qui contient l’adresse matérielle (adresse MAC) du client DHCPv4.

ClientName

Correspond à une chaîne Unicode terminée par null qui représente le nom de machine du client DHCPv4.

ClientComment

Pointeur vers une chaîne Unicode terminée par un caractère Null qui représente la description donnée au 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 (ordinateur serveur DHCPv4) qui a fourni un bail au client DHCPv4.

bClientType

Types possibles du client DHCPv4. Les valeurs possibles sont indiquées dans le tableau suivant.

Valeur	Signification
CLIENT_TYPE_UNSPECIFIED 0x00	Un client DHCPv4 autre que ceux définis dans cette table.
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 comprend à la fois 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

États possibles de l’adresse IPv4 donnée au client DHCPv4. Le tableau suivant représente les différentes valeurs et leur signification.

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

Status

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

ProbationEnds

Il s’agit d’un type DATE_TIME, contenant l’heure de fin de la probation si le client DHCPv4 est en probation. Pour cette période, le client DHCPv4 dispose d’un accès complet au réseau.

QuarantineCapable

Si la valeur est TRUE, le client DHCPv4 est activé pour la mise en quarantaine ; si la valeur est FALSE, ce n’est pas le cas.

FilterStatus

Valeur de l’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 caractères génériques dans la liste verte.
FILTER_STATUS_WILDCARD_MATCH_IN_DENY_LIST 0x00000010	L’adresse MAC du client DHCPv4 a une correspondance de caractères génériques dans la liste de refus.

Spécifications

En-tête	dhcpsapi.h