struktur DHCP_CLIENT_FILTER_STATUS_INFO (dhcpsapi.h)

Struktur DHCP_CLIENT_FILTER_STATUS_INFO menentukan informasi tentang klien DHCPv4, termasuk informasi status filter.

Sintaks

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;

Anggota

ClientIpAddress

DHCP_IP_ADDRESS nilai jenis yang berisi alamat IPv4 klien DHCPv4.

SubnetMask

Nilai jenis IP_MASK DHCP yang berisi alamat subnet mask IPv4 klien DHCPv4.

ClientHardwareAddress

Nilai GUID yang berisi alamat perangkat keras (alamat MAC) klien DHCPv4.

ClientName

Ppointer ke string Unicode yang dihentikan null yang mewakili nama komputer klien DHCPv4.

ClientComment

Penunjuk ke string Unicode yang dihentikan null yang mewakili deskripsi yang diberikan kepada klien DHCPv4.

ClientLeaseExpires

DATE_TIME struktur yang berisi waktu kedaluwarsa sewa untuk klien DHCPv4. Ini adalah waktu UTC yang diwakili dalam format FILETIME .

OwnerHost

DHCP_HOST_INFO struktur yang berisi informasi tentang komputer host (komputer server DHCPv4) yang telah memberikan sewa kepada klien DHCPv4.

bClientType

Kemungkinan jenis klien DHCPv4. Nilai yang mungkin diperlihatkan dalam tabel berikut ini.

Nilai	Makna
CLIENT_TYPE_UNSPECIFIED 0x00	Klien DHCPv4 selain yang ditentukan dalam tabel ini.
CLIENT_TYPE_DHCP 0x01	Klien DHCPv4 mendukung protokol DHCP.
CLIENT_TYPE_BOOTP 0x02	Klien DHCPv4 mendukung protokol BOOTP.
CLIENT_TYPE_BOTH 0x03	Klien DHCPv4 memahami protokol DHCPv4 dan BOOTP.
CLIENT_TYPE_RESERVATION_FLAG 0x04	Ada reservasi IPv4 yang dibuat untuk klien DHCPv4.
CLIENT_TYPE_NONE 0x64	Kompatibilitas mundur untuk alamat manual.

AddressState

Kemungkinan status alamat IPv4 yang diberikan kepada klien DHCPv4. Tabel berikut ini mewakili nilai yang berbeda dan maknanya.

Nilai	Makna
ADDRESS_STATE_OFFERED 0x00	Klien DHCPv4 telah ditawarkan alamat IPv4 ini.
ADDRESS_STATE_ACTIVE 0x01	Alamat IPv4 aktif dan memiliki catatan sewa klien DHCPv4 aktif.
ADDRESS_STATE_DECLINED 0x02	Permintaan alamat IPv4 ditolak oleh klien DHCPv4; oleh karena itu, ini adalah alamat IPv4 yang buruk.
ADDRESS_STATE_DOOM 0x03	Alamat IPv4 dalam status DOOMED dan akan dihapus.

Status

Enumerasi QuarantineStatus yang menentukan kemungkinan nilai status kesehatan untuk klien DHCPv4, seperti yang divalidasi di server NAP.

ProbationEnds

Jenis ini DATE_TIME, yang berisi waktu akhir pemeriksaan jika klien DHCPv4 sedang dalam pemeriksaan. Untuk periode waktu ini, klien DHCPv4 memiliki akses penuh ke jaringan.

QuarantineCapable

Jika TRUE, klien DHCPv4 diaktifkan karantina; jika FALSE, itu tidak.

FilterStatus

Nilai bendera bilangan bulat yang menentukan status filter lapisan tautan.

Nilai	Makna
FILTER_STATUS_NONE 0x00000001	Alamat MAC klien DHCPv4 tidak cocok dengan filter apa pun.
FILTER_STATUS_FULL_MATCH_IN_ALLOW_LIST 0x00000002	Alamat MAC klien DHCv4P sepenuhnya cocok dengan filter daftar yang diizinkan.
FILTER_STATUS_FULL_MATCH_IN_DENY_LIST 0x00000004	Alamat MAC klien DHCPv4 sepenuhnya cocok dengan filter daftar tolak.
FILTER_STATUS_WILDCARD_MATCH_IN_ALLOW_LIST 0x00000008	Alamat MAC klien DHCPv4 memiliki kecocokan kartubebas dalam daftar izinkan.
FILTER_STATUS_WILDCARD_MATCH_IN_DENY_LIST 0x00000010	Alamat MAC klien DHCPv4 memiliki kecocokan kartubebas dalam daftar tolak.

Persyaratan

Header	dhcpsapi.h