DhcpGetClientInfoVQ 函式 (dhcpsapi.h)

  • 發行項

DhcpGetClientInfoVQ函式會從 DHCP 伺服器資料庫擷取 DHCP 用戶端租用記錄資訊。

語法

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

參數

[in] ServerIpAddress

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

[in] SearchInfo

DHCP_SEARCH_INFO結構的指標，定義用來搜尋 DHCP 伺服器上用戶端租用記錄資料庫的索引鍵，以取得特定用戶端記錄。

[out] ClientInfo

成功搜尋作業所傳回 之DHCP_CLIENT_INFO_VQ 結構的指標。

傳回值

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

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

備註

此函式的呼叫端必須釋放ClientInfo中傳回之 DHCP_CLIENT_INFO_VQ結構所使用的記憶體。

需求

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

另請參閱

DHCP_CLIENT_INFO_VQ

DHCP_SEARCH_INFO