DHCP_CLIENT_INFO_VQ-Struktur (dhcpsapi.h)

  • Artikel

Die DHCP_CLIENT_INFO_VQ-Struktur definiert Informationen zum DHCPv4-Client.

Syntax

typedef struct _DHCP_CLIENT_INFO_VQ {
  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;
} DHCP_CLIENT_INFO_VQ, *LPDHCP_CLIENT_INFO_VQ;

Member

ClientIpAddress

DHCP_IP_ADDRESS Typwert, der die IPv4-Adresse des DHCPv4-Clients enthält.

SubnetMask

DHCP IP_MASK Typwert, der die IPv4-Subnetzmaskenadresse des DHCPv4-Clients enthält.

ClientHardwareAddress

GUID-Wert, der die Hardwareadresse (MAC-Adresse) des DHCPv4-Clients enthält.

ClientName

Ppointer auf eine Unicode-Zeichenfolge mit Null-Endung, die den Computernamen des DHCPv4-Clients darstellt.

ClientComment

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die die Beschreibung darstellt, die dem DHCPv4-Client gegeben wurde.

ClientLeaseExpires

DATE_TIME Struktur, die die Leaseablaufzeit für den DHCPv4-Client enthält. Dies ist die UTC-Zeit, die im FILETIME-Format dargestellt wird.

OwnerHost

DHCP_HOST_INFO Struktur, die Informationen zum Hostcomputer (DHCPv4-Servercomputer) enthält, der eine Lease für den DHCPv4-Client bereitgestellt hat.

bClientType

Mögliche Typen des DHCPv4-Clients. Die möglichen Werte sind in der folgenden Tabelle aufgeführt.

Wert Bedeutung
CLIENT_TYPE_UNSPECIFIED
0x00
 Ein DHCPv4-Client, der nicht in dieser Tabelle definiert ist.
CLIENT_TYPE_DHCP
0x01
 Der DHCPv4-Client unterstützt das DHCP-Protokoll.
CLIENT_TYPE_BOOTP
0x02
 Der DHCPv4-Client unterstützt das BOOTP-Protokoll.
CLIENT_TYPE_BOTH
0x03
 Der DHCPv4-Client versteht sowohl das DHCPv4- als auch das BOOTP-Protokoll.
CLIENT_TYPE_RESERVATION_FLAG
0x04
 Für den DHCPv4-Client wurde eine IPv4-Reservierung erstellt.
CLIENT_TYPE_NONE
0x64
 Abwärtskompatibilität für die manuelle Adressierung.

AddressState

Mögliche Zustände der IPv4-Adresse, die dem DHCPv4-Client zugewiesen werden. Die folgende Tabelle stellt die verschiedenen Werte und deren Bedeutung dar.

Wert Bedeutung
ADDRESS_STATE_OFFERED
0x00
 Dem DHCPv4-Client wurde diese IPv4-Adresse angeboten.
ADDRESS_STATE_ACTIVE
0x01
 Die IPv4-Adresse ist aktiv und verfügt über einen aktiven DHCPv4-Clientleasingdatensatz.
ADDRESS_STATE_DECLINED
0x02
 Die IPv4-Adressanforderung wurde vom DHCPv4-Client abgelehnt. Daher handelt es sich um eine ungültige IPv4-Adresse.
ADDRESS_STATE_DOOM
0x03
 Die IPv4-Adresse befindet sich im DOOMED-Zustand und wird gelöscht.

Status

QuarantineStatus-Enumeration, die mögliche Integritäts- status Werte für den DHCPv4-Client angibt, wie auf dem NAP-Server überprüft.

ProbationEnds

Dies ist vom Typ DATE_TIME und enthält die Endzeit der Probezeit, wenn sich der DHCPv4-Client auf Probe befindet. Für diesen Zeitraum hat der DHCPv4-Client Vollzugriff auf das Netzwerk.

QuarantineCapable

Wenn TRUE, ist der DHCPv4-Client quarantänefähig. , wenn FALSE, ist dies nicht.

Hinweise

DHCP_CLIENT_INFO_VQ erweitert die DHCP_CLIENT_INFO_V5-Struktur, indem Informationen zu den NAP-Einstellungen des DHCPv4-Clients eingeschlossen werden.

Anforderungen

   
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile dhcpsapi.h

Weitere Informationen

DHCP-Serververwaltungstypdefinitionen

DHCP_HOST_INFO