DhcpGetClientInfoV4 函式 (dhcpsapi.h)

  • 發行項

DhcpGetClientInfoV4 函式會傳回特定 DHCP 用戶端的相關信息。 此函式會傳回包含用戶端類型資訊的DHCP_CLIENT_INFO_V4結構，以擴充 DhcpGetClientInfo。

語法

DWORD DHCP_API_FUNCTION DhcpGetClientInfoV4(
  [in]  DHCP_CONST WCHAR            *ServerIpAddress,
  [in]  DHCP_CONST DHCP_SEARCH_INFO *SearchInfo,
  [out] LPDHCP_CLIENT_INFO_V4       *ClientInfo
);

參數

[in] ServerIpAddress

指定 DHCP 伺服器的 IP 位址。

[in] SearchInfo

DHCP_SEARCH_INFO 結構，其中包含用來選取特定 DHCP 用戶端的搜尋參數。

[out] ClientInfo

DHCP_CLIENT_INFO_V4 結構，其中包含描述最符合所提供搜尋參數之 DHCP 客戶端的資訊。 如果找不到任何用戶端，此參數會是 Null。

注意  

此參數的記憶體必須使用 DhcpRpcFreeMemory 釋放。

 

傳回值

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

傳回碼 Description
ERROR_ACCESS_DENIED
 此呼叫是由不是「DHCP 系統管理員」安全組成員的用戶端所執行。
ERROR_DHCP_JET_ERROR
 存取 DHCP 伺服器的資料庫時發生錯誤。

規格需求

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

另請參閱

DHCP_CLIENT_INFO_V4

DHCP_SEARCH_INFO

DhcpGetClientInfo

DhcpSetClientInfo