DhcpEnumSubnetElementsV6 函式 (dhcpsapi.h)

  • 發行項

DhcpEnumSubnetElementsV6 函式會傳回特定 DHCP 子網元素的列舉清單。

語法

DWORD DHCP_API_FUNCTION DhcpEnumSubnetElementsV6(
  [in]      LPWSTR                              ServerIpAddress,
  [in]      DHCP_IPV6_ADDRESS                   SubnetAddress,
  [in]      DHCP_SUBNET_ELEMENT_TYPE_V6         EnumElementType,
  [in, out] DHCP_RESUME_HANDLE                  *ResumeHandle,
  [in]      DWORD                               PreferredMaximum,
  [out]     LPDHCP_SUBNET_ELEMENT_INFO_ARRAY_V6 *EnumElementInfo,
  [out]     DWORD                               *ElementsRead,
  [out]     DWORD                               *ElementsTotal
);

參數

[in] ServerIpAddress

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

[in] SubnetAddress

DHCP_IPV6_ADDRESS值，指定將列舉其元素的子網。

[in] EnumElementType

DHCP_SUBNET_ELEMENT_TYPE_V6列舉值，指出要列舉的子網項目類型。

[in, out] ResumeHandle

識別列舉作業 之DHCP_RESUME_HANDLE 值的指標。 一開始，這個值應該是零，而成功呼叫會傳回用於後續列舉要求的句柄值。 例如，如果 PreferredMaximum 設定為 1000 個字節，而 2000 個字節的子網元素會儲存在伺服器上，則可以在擷取前 1000 個字節之後使用繼續句柄，以便在後續呼叫上取得下一個 1000 個字節，依此類推。

[in] PreferredMaximum

指定要傳回之子網元素的慣用位元組數目上限。 如果剩餘未列舉的選項數目 (位元組) 小於此值，則會傳回該數量。

[out] EnumElementInfo

DHCP_SUBNET_ELEMENT_INFO_ARRAY_V6 結構的指標，其中包含指定子網可用之所有專案的列舉清單。 如果沒有元素可用於列舉，這個值將會是 Null。

[out] ElementsRead

DWORD 值的指標，指定 EnumElementInfo 中傳回的子網元素數目。

[out] ElementsTotal

指定指定子網元素總數的 DWORD 值指標。

傳回值

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

傳回碼 Description
ERROR_INVALID_PARAMETER
 參數無效。
ERROR_NO_MORE_ITEMS
 沒有其他可列舉的項目。
ERROR_NOT_ENOUGH_MEMORY
 記憶體失敗。
ERROR_MORE_DATA
 更多數據可供列舉。

規格需求

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