DhcpEnumSubnetsV6 函式 (dhcpsapi.h)
DhcpEnumSubnetsV6 函式會傳回 DHCP 伺服器上定義的子網列舉清單。
語法
DWORD DHCP_API_FUNCTION DhcpEnumSubnetsV6(
[in] DHCP_CONST WCHAR *ServerIpAddress,
[in, out] DHCP_RESUME_HANDLE *ResumeHandle,
[in] DWORD PreferredMaximum,
[out] LPDHCPV6_IP_ARRAY *EnumInfo,
[out] DWORD *ElementsRead,
[out] DWORD *ElementsTotal
);
參數
[in] ServerIpAddress
指定 DHCP 伺服器的 IP 位址或主機名的 Unicode 字串指標。
[in, out] ResumeHandle
識別列舉作業 之DHCP_RESUME_HANDLE 值的指標。 一開始,這個值應該是零,而成功呼叫會傳回用於後續列舉要求的句柄值。 例如,如果 PreferredMaximum 設定為 100,且 200 個子網位址儲存在伺服器上,則可以在擷取前 100 個子網之後使用繼續句柄,以便在後續呼叫上取得下一個 100 個,依此類推。
[in] PreferredMaximum
指定要傳回的慣用子網位址數目上限。 如果剩餘未確認的選項數目小於此值,則會傳回該數量。
[out] EnumInfo
DHCPV6_IP_ARRAY 結構的指標,其中包含 DHCP 伺服器上可用的子網標識碼。 如果未定義任何子網,這個值將會是 Null。
[out] ElementsRead
DWORD 值的指標,指定 EnumInfo 中傳回的子網位址數目。
[out] ElementsTotal
DWORD 值的指標,指定尚未列舉之 DHCP 伺服器上定義的子網數目。
傳回值
此函式會在成功呼叫時傳回 ERROR_SUCCESS 。 如果使用相同的 ResumeHandle 值進行呼叫,且伺服器上所有專案都已列舉,這個方法會傳回ERROR_NO_MORE_ITEMS,且 ElementsRead 和 ElementsTotal 設定為 0。 否則,它會傳回其中一個 DHCP 伺服器管理 API 錯誤碼。
傳回碼 | Description |
---|---|
|
參數無效。 |
|
沒有其他可列舉的項目。 |
|
記憶體失敗。 |
|
更多數據可供列舉。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | dhcpsapi.h |
程式庫 | Dhcpsapi.lib |
Dll | Dhcpsapi.dll |
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應