Partager via

structure DHCPV4_FAILOVER_CLIENT_INFO (dhcpsapi.h)

La structure DHCPV4_FAILOVER_CLIENT_INFO définit les statistiques d’étendue du serveur DHCP qui font partie d’une relation de basculement.

Syntaxe

typedef struct _DHCPV4_FAILOVER_CLIENT_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            SentPotExpTime;
  DWORD            AckPotExpTime;
  DWORD            RecvPotExpTime;
  DWORD            StartTime;
  DWORD            CltLastTransTime;
  DWORD            LastBndUpdTime;
  DWORD            BndMsgStatus;
  LPWSTR           PolicyName;
  BYTE             Flags;
} DHCPV4_FAILOVER_CLIENT_INFO, *LPDHCPV4_FAILOVER_CLIENT_INFO;

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 (serveur DHCPv4) qui a fourni un bail au client DHCPv4.

bClientType

Valeur qui spécifie le type de client DHCPv4. Les valeurs possibles sont ci-dessous.

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
 Il existe une réservation IPv4 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. LSB est bit 0 et MSB est bit 7. Les valeurs possibles sont ci-dessous.

BIT 0 et BIT 1 indiquent l’état d’adresse IPv4 du client DHCPv4, comme indiqué dans le tableau suivant.

Valeur Signification
ADDRESS_STATE_OFFERED
0x0
 Le client DHCPv4 est proposé à cette adresse IPv4.
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 dans 'état de DOOMED et doit être supprimée.
 

Bit 2 et BIT 3 signifient les informations relatives à la protection des noms pour l’adresse IPv4 louée, comme indiqué dans le tableau suivant.

Valeur Signification
ADDRESS_BIT_NO_DHCID
0x0
 L’adresse est louée au client DHCPv4 sans DHCID telle que définie dans les sections 3 et 3.5 de RFC4701.
ADDRESS_BIT_DHCID_NO_CLIENTIDOPTION
0x1
 L’adresse est louée au client DHCPv4 avec DHCID, mais sans l’option ID client telle que définie dans les sections 3 et 3.5 de RFC4701.
ADDRESS_BIT_DHCID_WITH_CLIENTIDOPTION
0x2
 L’adresse est louée au client DHCPv4 avec DHCID et l’option ID client telle que définie dans les sections 3 et 3.5 de RFC4701.
ADDRESS_BIT_DHCID_WITH_DUID
0x3
 L’adresse est louée au client DHCPv4 avec DHCID et le DUID du client, comme défini dans les sections 3 et 3.5 de RFC4701.
 

BIT 4, BIT 5, BIT 6 et BIT 7 spécifient des informations relatives au DNS, comme indiqué dans le tableau suivant.

Valeur Signification
ADDRESS_BIT_CLEANUP
0x1
 La mise à jour DNS de l’enregistrement de bail client DHCPv4 doit être supprimée du serveur DNS lorsque le bail est supprimé.
ADDRESS_BIT_BOTH_REC
0x2
 La mise à jour DNS doit être envoyée à la fois pour DNS_A_DATA et les enregistrements de ressources de type DNS_PTR_DATA.
ADDRESS_BIT_UNREGISTERED
0x4
 La mise à jour DNS n’est pas terminée pour l’enregistrement de bail.
ADDRESS_BIT_DELETED
0x8
 Le bail d’adresse a expiré, mais les mises à jour DNS pour l’enregistrement de bail n’ont pas été supprimées du serveur DNS.

Status

QuarantineStatus énumération qui spécifie les valeurs d’état d’intégrité possibles pour le client DHCPv4 comme validé 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 a un accès complet au réseau pour cette période. Il s’agit de l’heure UTC représentée au format FILETIME.

QuarantineCapable

TRUE, si le client DHCPv4 est en quarantaine ; Sinon, il est FALSE.

SentPotExpTime

Temps, en secondes, de délai d’expiration potentiel envoyé au serveur partenaire.

AckPotExpTime

Temps, en secondes, de délai d’expiration potentiel reconnu par le serveur partenaire.

RecvPotExpTime

Temps, en secondes, de délai d’expiration potentiel reçu du serveur partenaire.

StartTime

Durée, en secondes, depuis que le bail du client est entré dans son état actuel.

CltLastTransTime

Durée, en secondes, depuis le client-last-transaction-time.

LastBndUpdTime

Durée, en secondes, depuis la dernière mise à jour du bail client DHCPv4 par le serveur partenaire.

BndMsgStatus

Réservé. N’utilisez pas.

PolicyName

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

Flags

Réservé. N’utilisez pas.

Exigences

Exigence Valeur
client minimum pris en charge Aucun pris en charge
serveur minimum pris en charge Windows Server 2012 [applications de bureau uniquement]
d’en-tête dhcpsapi.h

Voir aussi

DHCPV4_FAILOVER_CLIENT_INFO_ARRAY