DhcpSetClientInfoVQ 函式 (dhcpsapi.h)

  • 發行項

DhcpSetClientInfoVQ 函式會設定或修改 DHCP 伺服器記錄資料庫中現有的 DHCP 用戶端租用記錄。

語法

DWORD DHCP_API_FUNCTION DhcpSetClientInfoVQ(
  [in] DHCP_CONST WCHAR               *ServerIpAddress,
  [in] DHCP_CONST DHCP_CLIENT_INFO_VQ *ClientInfo
);

參數

[in] ServerIpAddress

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

[in] ClientInfo

包含 DHCP 用戶端租用記錄的 DHCP_CLIENT_INFO_VQ 結構的指標，以在 DHCP 伺服器資料庫中加入或修改。

傳回值

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

傳回碼 Description
ERROR_ACCESS_DENIED
 此呼叫是由不是「DHCP 系統管理員」安全組成員的用戶端所執行。
ERROR_DHCP_JET_ERROR
 存取 DHCPv6 伺服器的資料庫時發生錯誤。
ERROR_DHCP_INVALID_PARAMETER
 提供的用戶端硬體地址數據為 NULL ，或長度設定為零，或子網掩碼不正確。

規格需求

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