DHCP_CLIENT_FILTER_STATUS_INFO結構 (dhcpsapi.h)

DHCP_CLIENT_FILTER_STATUS_INFO結構會定義 DHCPv4 用戶端的相關資訊，包括篩選狀態資訊。

語法

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;

成員

ClientIpAddress

DHCP_IP_ADDRESS 類型值，其中包含 DHCPv4 用戶端的 IPv4 位址。

SubnetMask

DHCP IP_MASK 類型值，其中包含 DHCPv4 用戶端的 IPv4 子網路遮罩位址。

ClientHardwareAddress

包含 DHCPv4 用戶端) 硬體位址 (MAC 位址的 GUID 值。

ClientName

Ppointer 至 Null 終止的 Unicode 字串，代表 DHCPv4 用戶端的電腦名稱稱。

ClientComment

Null 終止的 Unicode 字串指標，代表提供給 DHCPv4 用戶端的描述。

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_RESER加值稅ION_FLAG 0x04	已為 DHCPv4 用戶端建立 IPv4 保留。
CLIENT_TYPE_NONE 0x64	手動定址的回溯相容性。

AddressState

提供給 DHCPv4 用戶端之 IPv4 位址的可能狀態。 下表代表不同的值及其意義。

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

Status

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

ProbationEnds

這是類型 DATE_TIME，如果 DHCPv4 用戶端在探查時，則包含探查的結束時間。 在這段時間內，DHCPv4 用戶端具有網路的完整存取權。

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 位址在拒絕清單中具有萬用字元比對。

需求

標頭	dhcpsapi.h