structure DHCPV4_FAILOVER_CLIENT_INFO (dhcpsapi.h)

  • Article

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
 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. Le LSB est le bit 0 et le MSB le bit 7. Les valeurs possibles sont ci-dessous.

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

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.
 

BIT 2 et BIT 3 signifient des 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 , comme défini dans les sections 3 et 3.5 de la RFC4701.
ADDRESS_BIT_DHCID_NO_CLIENTIDOPTION
0x1
 L’adresse est louée au client DHCPv4 avec DHCID , mais sans l’option ID client comme défini dans les sections 3 et 3.5 de la RFC4701.
ADDRESS_BIT_DHCID_WITH_CLIENTIDOPTION
0x2
 L’adresse est louée au client DHCPv4 avec DHCID et l’option d’ID client, comme défini dans les sections 3 et 3.5 de la RFC4701.
ADDRESS_BIT_DHCID_WITH_DUID
0x3
 L’adresse est louée au client DHCPv4 avec DHCID et le DUID client, comme défini dans les sections 3 et 3.5 de la 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 pour 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 pour les enregistrements de ressources de type DNS_A_DATA et 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 du bail n’ont pas été supprimées du serveur DNS.

Status

Énumération QuarantineStatus qui spécifie les valeurs d’intégrité possibles status pour le client DHCPv4 telles qu’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.

SentPotExpTime

Heure, en secondes, du délai d’expiration potentiel envoyé au serveur partenaire.

AckPotExpTime

Durée, en secondes, du délai d’expiration potentiel reconnu par le serveur partenaire.

RecvPotExpTime

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

StartTime

Délai, en secondes, depuis que le bail client est entré dans son état actuel.

CltLastTransTime

Durée, en secondes, depuis l’heure de la dernière transaction du client.

LastBndUpdTime

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

BndMsgStatus

Réservé. Ne pas utiliser.

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.

Flags

Réservé. Ne pas utiliser.

Spécifications

   
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

DHCPV4_FAILOVER_CLIENT_INFO_ARRAY