PeerGetNextItem 函式 (p2p.h)
PeerGetNextItem 函式會從對等列舉傳回特定數目的專案。
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGetNextItem(
[in] HPEERENUM hPeerEnum,
[in, out] ULONG *pCount,
[out] PVOID **pppvItems
);
參數
[in] hPeerEnum
處理從中擷取專案的對等列舉。 這個句柄是由對等列舉函式所產生。
[in, out] pCount
整數的指標，指定要從對等列舉擷取的項目數目。 傳回時，它會包含 ppvItems 中的項目數。 此參數不可為 NULL。
[out] pppvItems
接收對等列舉中下一個 pCount 專案的指標陣列指標。 例如，記錄或成員資訊區塊的數據取決於實際的對等列舉類型。
傳回值
如果作業成功，則傳回 S_OK 。 否則，函式會傳回下列其中一個值。
| 傳回碼 | Description |
|---|---|
|
其中一個參數無效。 |
|
記憶體不足，無法執行指定的作業。 |
備註
PeerGetNextItem 函式會傳回下列內容：
- 等於或小於 pCount 中指定的數量的專案。
- 當數量大於可用項目數目時，小於指定金額的專案清單。
注意 例如，當 pCount 的輸入值為 10 且列舉的其餘部分為 5 個專案時，只會傳回 5 個專案，且 pCount 所指向的值會設定為 5。
當函式傳回 pCount 參數設定為零 (0) 時，就會指出列舉的結尾。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 搭配 SP1 與適用於Windows XP 的進階網络套件 |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | p2p.h |
| 程式庫 | P2P.lib |
| Dll | P2P.dll |