DHCP_CLIENT_INFO_PB 結構 (dhcpsapi.h)

DHCP_CLIENT_INFO_PB結構會定義 DHCPv4 用戶端的相關信息，包括篩選狀態資訊和導致 IPv4 位址指派的任何原則。

語法

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;

成員

ClientIpAddress

DHCP_IP_ADDRESS 結構，其中包含 DHCPv4 用戶端 IPv4 位址。

SubnetMask

DHCP IP_MASK 結構，其中包含 DHCPv4 用戶端 IPv4 子網掩碼。

ClientHardwareAddress

DHCP_CLIENT_UID 結構，其中包含 DHCPv4 用戶端) MAC 位址 (硬體位址。

ClientName

代表 DHCPv4 用戶端電腦名稱的 Null 終止 Unicode 字串指標。

ClientComment

代表 DHCPv4 用戶端描述之 Null 終止 Unicode 字串的指標。

ClientLeaseExpires

DATE_TIME 結構，其中包含 DHCPv4 用戶端的租用到期時間。 這是 以 FILETIME 格式表示的 UTC 時間。

OwnerHost

DHCP_HOST_INFO 結構，其中包含提供 DHCPv4 用戶端租用之主) 計算機 (DHCPv4 伺服器電腦的相關信息。

bClientType

指定 DHCPv4 用戶端類型的值。 可能的值如下：

值	意義
CLIENT_TYPE_UNSPECIFIED 0x00	DHCPv4 用戶端未定義於伺服器資料庫中。
CLIENT_TYPE_DHCP 0x01	DHCPv4 用戶端支援 DHCP 通訊協定。
CLIENT_TYPE_BOOTP 0x02	DHCPv4 用戶端支援 BOOTP 通訊協定。
CLIENT_TYPE_BOTH 0x03	DHCPv4 用戶端同時支援 DHCPv4 和 BOOTP 通訊協定
CLIENT_TYPE_RESERVATION_FLAG 0x04	已為 DHCPv4 用戶端建立 IPv4 保留。
CLIENT_TYPE_NONE 0x64	手動尋址的回溯相容性。

AddressState

指定IPv4位址各種狀態的值。 可能的值如下：

值	意義
ADDRESS_STATE_OFFERED 0x0	DHCPv4 用戶端提供此 IPv4 位址。
ADDRESS_STATE_ACTIVE 0x1	IPv4 位址為作用中，且具有作用中的 DHCPv4 用戶端租用記錄。
ADDRESS_STATE_DECLINED 0x2	DHCPv4 用戶端拒絕IPv4 位址要求;因此，這是不正確的 IPv4 位址。
ADDRESS_STATE_DOOM 0x3	IPv4 位址處於 DOOMED 狀態， 因此會遭到刪除。

Status

QuarantineStatus 列舉，指定 DHCPv4 用戶端的可能健康情況狀態值，如 NAP 伺服器所驗證。

ProbationEnds

如果 DHCPv4 用戶端在探查時，DATE_TIME包含探查結束時間的結構。 DHCPv4 用戶端對此時間週期具有網路的完整存取權。 這是 以 FILETIME 格式表示的 UTC 時間。

QuarantineCapable

TRUE 是表示 如果 DHCPv4 用戶端已啟用隔離;否則為 FALSE。

FilterStatus

指定連結層篩選狀態的整數旗標值。

值	意義
FILTER_STATUS_NONE 0x00000001	DHCPv4 用戶端 MAC 位址不符合任何篩選條件。
FILTER_STATUS_FULL_MATCH_IN_ALLOW_LIST 0x00000002	DHCv4P 用戶端 MAC 位址完全符合允許清單篩選條件。
FILTER_STATUS_FULL_MATCH_IN_DENY_LIST 0x00000004	DHCPv4 用戶端 MAC 位址完全符合拒絕列表篩選條件。
FILTER_STATUS_WILDCARD_MATCH_IN_ALLOW_LIST 0x00000008	DHCPv4 用戶端 MAC 位址在允許清單中具有通配符相符專案。
FILTER_STATUS_WILDCARD_MATCH_IN_DENY_LIST 0x00000010	DHCPv4 用戶端 MAC 位址在拒絕清單中具有通配符比對。

PolicyName

Null 終止的 Unicode 字串指標，表示租用中產生對 DHCPv4 用戶端的 IPv4 位址指派的 DHCP 伺服器原則名稱。

規格需求

需求	值
最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2012 [僅限傳統型應用程式]
標頭	dhcpsapi.h

另請參閱

DHCP_CLIENT_INFO_PB_ARRAY

DhcpV4CreateClientInfo

DhcpV4GetClientInfo