DhcpV6CreateClientInfo 函式 (dhcpsapi.h)

  • 發行項

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

語法

DWORD DHCP_API_FUNCTION DhcpV6CreateClientInfo(
  [in, optional] DHCP_CONST WCHAR                 *ServerIpAddress,
  [in]           DHCP_CONST LPDHCP_CLIENT_INFO_V6 ClientInfo
);

參數

[in, optional] ServerIpAddress

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

[in] ClientInfo

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

傳回值

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

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

值 意義
ERROR_INVALID_PARAMETER
 ClientInfo 參數中的 ClientDUID 是 NULL 或零長度緩衝區。
ERROR_ACCESS_DENIED
 此呼叫是由不是 DHCP 系統管理員 安全組成員的用戶端所執行。
ERROR_DHCP_SUBNET_NOT_PRESENT
 指定的子網不存在。 在此情況下，ClientInfo 參數中沒有對應至 ClientIpAddress 的子網。
ERROR_DHCP_CLIENT_EXISTS
 提供的 DHCP 用戶端記錄已存在於 DHCP 伺服器資料庫中。

規格需求

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

另請參閱

DhcpV4CreateClientInfo

DhcpV4GetClientInfo