DhcpScanDatabase 函式 (dhcpsapi.h)

  • 發行項

DhcpScanDatabase函式會列舉記憶體內部快取與伺服器資料庫之間未同步處理的租用 DHCPv4 用戶端 IPv4 位址。

語法

DWORD DHCP_API_FUNCTION DhcpScanDatabase(
  [in]  DHCP_CONST WCHAR *ServerIpAddress,
  [in]  DHCP_IP_ADDRESS  SubnetAddress,
  [in]  DWORD            FixFlag,
  [out] LPDHCP_SCAN_LIST *ScanList
);

參數

[in] ServerIpAddress

指定 DHCP 伺服器的 IP 位址或主機名稱的 Unicode 字串。

[in] SubnetAddress

DHCP_IP_ADDRESS 值，指定其租用將會掃描其租用的子網，以取得已還原的用戶端租用 IP 位址。

[in] FixFlag

指定一組位旗標，指出在 DHCPv4 伺服器上同步處理兩者時，記憶體內部快取或用戶端租用資料庫是否應該是修正的明確來源。 這些旗標會在 DHCP_SCAN_FLAG中列舉。

[out] ScanList

DHCP_SCAN_LIST 結構，其中包含未同步之租用用戶端 IP 位址的傳回清單。

傳回值

此函式會在成功呼叫時傳回 ERROR_SUCCESS 。 否則，它會傳回其中一個 DHCP 伺服器管理 API 錯誤碼。

傳回碼 描述
ERROR_ACCESS_DENIED
 此呼叫是由不是「DHCP 系統管理員」安全性群組成員的用戶端所執行。
ERROR_DHCP_JET_ERROR
 存取 DHCPv4 伺服器的資料庫時發生錯誤。
ERROR_DHCP_SUBNET_NOT_PRESENT
 指定的子網未定義于 DHCPv4 伺服器上。

備註

DHCPv4 伺服器上定義的每一個租用 DHCPv4 用戶端 IPv4 位址都有記憶體內部存放區中的專案，其可作為快取來加速租用擷取，並在用戶端租用資料庫中正確執行。 DhcpScanDatabase 會列舉存在於記憶體內部存放區且不存在於資料庫中的 DHCPv4 用戶端 IPv4 位址，或存在於資料庫中但不存在於記憶體內部存放區中的位址。

此程式是必要的，因為 DHCPv4 伺服器會維護經常存取之用戶端租用的記憶體內部快取，用來改善效能，但可能會變成相對於伺服器持續性用戶端租用資料庫的還原同步處理。 因此，必須協調這兩個存放區，並更新用戶端租用 IP 位址的記憶體內部版本，或儲存在資料庫中的用戶端租用 IP 位址。 此作業所傳回 的DHCP_SCAN_LIST 結構包含由 FixFlag 參數中設定的慣用位置所指定的「明確」用戶端租用。

需求

   
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2008、Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 dhcpsapi.h
程式庫 Dhcpsapi.lib
Dll Dhcpsapi.dll

另請參閱

DHCP_SCAN_LIST