dhcpGetClassInfo 函式 (dhcpsapi.h)

  • 發行項

DhcpGetClassInfo函式會傳回在特定 DHCP 伺服器上設定的使用者或廠商類別資訊。

語法

DWORD DhcpGetClassInfo(
  [in]  LPWSTR            ServerIpAddress,
  [in]  DWORD             ReservedMustBeZero,
  [in]  LPDHCP_CLASS_INFO PartialClassInfo,
  [out] LPDHCP_CLASS_INFO *FilledClassInfo
);

參數

[in] ServerIpAddress

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

[in] ReservedMustBeZero

保留的。 此參數必須設定為 0。

[in] PartialClassInfo

DHCP_CLASS_INFO 結構，其中包含呼叫端為下列成員提供的資料，並初始化所有其他欄位。

  • ClassName
  • ClassData
  • ClassDataLength
這些欄位不得為 Null。

[out] FilledClassInfo

DHCP_CLASS_INFO 包含完整類別資訊的查閱之後傳回的結構。

注意  

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

 

傳回值

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

傳回碼 描述
ERROR_ACCESS_DENIED
 此呼叫是由不是「DHCP 系統管理員」安全性群組成員的用戶端所執行。
ERROR_INVALID_PARAMETER
 PartialClassInfo中提供的DHCP_CLASS_INFO結構具有一或多個必要成員的 Null 或零值。
ERROR_DHCP_CLASS_NOT_FOUND
 找不到符合所提供資訊的類別名稱。

備註

DHCP 類別是用戶端的特定類別，由廠商或使用者定義。 廠商定義的類別範例是所有 Windows 8 用戶端，而 Microsoft 作為廠商。 使用者定義的類別是由使用者或系統管理員所選取特定屬性的用戶端所組成，例如支援無線連線的所有膝上型電腦或用戶端。

需求

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

另請參閱

DHCP_CLASS_INFO

DhcpCreateClass