DhcpV4CreateClientInfo 函式 (dhcpsapi.h)

  • 發行項

DhcpV4CreateClientInfo函式會在 DHCP 伺服器資料庫中建立 DHCPv4 用戶端租用記錄。

語法

DWORD DHCP_API_FUNCTION DhcpV4CreateClientInfo(
  [in, optional] DHCP_CONST WCHAR                 *ServerIpAddress,
  [in]           DHCP_CONST LPDHCP_CLIENT_INFO_PB ClientInfo
);

參數

[in, optional] ServerIpAddress

Null 終止的 Unicode 字串指標，表示 DHCP 伺服器的 IP 位址或主機名稱。

[in] ClientInfo

包含 DHCP 用戶端租用記錄資訊的 DHCP_CLIENT_INFO_PB 結構的指標。 需要此結構的 ClientIpAddress 和 ClientHardwareAddress 欄位，所有其他欄位都是選擇性的。

傳回值

如果函式成功，則會傳回 ERROR_SUCCESS。

如果函式失敗，它會從 DHCP 伺服器管理 API 錯誤碼傳回下列其中一個錯誤碼或錯誤碼。

值 意義
ERROR_INVALID_PARAMETER
 一或多個參數無效。
ERROR_ACCESS_DENIED
 此呼叫是由不是 DHCP 系統管理員 安全性群組成員的用戶端所執行。
ERROR_DHCP_SUBNET_NOT_PRESENT
 在 ClientInfo內傳遞的ClientIpAddress不符合 DHCP 伺服器上設定的任何 DHCPv4 範圍。
ERROR_DHCP_CLIENT_EXISTS
 提供的 DHCP 用戶端記錄已存在於 DHCP 伺服器資料庫中。

備註

如果沒有與伺服器上設定 的 ClientIpAddress 相對應的範圍，則此函式不允許建立租用，而是傳回 ERROR_DHCP_SUBNET_NOT_PRESENT。 它會將指定的用戶端 IP 位址標示為無法使用 (或分散式) ，以避免 IP 衝突。 因此標示的位址也會反映在範圍的位址統計資料中。

不同于DhcpCreateClientInfoVQ，此函式會在建立租用記錄時，使用DHCP_CLIENT_INFO_PB結構內傳遞至ClientInfo的bClientType、AddressState、Status、ProbationEnds和QuarantineCapable欄位。 如果在新租用記錄的ClientInfo內傳遞，它也會新增PolicyName欄位。 PolicyName與 DHCP 伺服器或對應範圍上設定的有效原則沒有驗證。

需求

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

另請參閱

DhcpV4GetClientInfo

DhcpV6CreateClientInfo