DhcpServerQueryAttributes 函式 (dhcpsapi.h)

  • 發行項

DhcpServerQueryAttributes 函式會傳回 DHCP 伺服器上設定的屬性陣列。

語法

DWORD DhcpServerQueryAttributes(
  [in]  LPWSTR              ServerIpAddr,
  [in]  ULONG               dwReserved,
  [in]  ULONG               dwAttribCount,
  [in]  DHCP_ATTRIB_ID []   pDhcpAttribs,
  [out] LPDHCP_ATTRIB_ARRAY *pDhcpAttribArr
);

參數

[in] ServerIpAddr

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

[in] dwReserved

保留的。 此值必須設定為零。

[in] dwAttribCount

指定 pDhcpAttribArr 中列出的屬性數目。

[in] pDhcpAttribs

指定要從中擷取對應屬性資訊的 DHCP_ATTRIB_ID值陣列 ， (長度 為 dwAttribCount) 。

[out] pDhcpAttribArr

DHCP_ATTRIB_ARRAY 結構的指標，其中包含直接對應至 pDhcpAttribs[] 中指定的屬性標識符值。

傳回值

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

備註

DHCP 伺服器屬性是可查詢以判斷支援和可用功能的值。

此函式的呼叫端應該會在使用後釋放 pDhcpAttribs 和 pDhcpAttribArr 所指向的記憶體。

規格需求

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

另請參閱

DHCP_ATTRIB_ARRAY

DhcpServerQueryAttribute