PeerGraphGetNextItem 函式 (p2p.h)
PeerGraphGetNextItem 函式會取得下列函式呼叫所建立之列舉中的下一個專案或專案，此函式會傳回對等列舉句柄：
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphGetNextItem(
[in] HPEERENUM hPeerEnum,
[in, out] ULONG *pCount,
[out] PVOID **pppvItems
);
參數
[in] hPeerEnum
列舉的句柄。
[in, out] pCount
輸入會指定要取得的項目數。
輸出會接收取得的實際項目數目。
注意 如果 pCount 是零 (0) 輸出，則會達到列舉的結尾。
[out] pppvItems
接收所要求專案的指標陣列。 陣列中包含的指標數目是由 pCount 的輸出值所指定。 傳回的實際數據取決於列舉的類型。 傳回的結構類型如下： PEER_CONNECTION_INFO、 PEER_NODE_INFO和 PEER_RECORD
傳回值
如果函式呼叫成功，傳回值 會S_OK。 否則，它會傳回下列其中一個值。
| 傳回碼 | Description |
|---|---|
|
一個參數無效。 |
|
記憶體不足，無法執行指定的作業。 |
|
使用這個函式之前，必須先使用 對PeerGraphStartup 的呼叫來初始化圖形。 |
備註
當不再需要數據時，呼叫 PeerGraphFreeData 即可免費 ppvItems。
應用程式可以要求一系列專案來取得。 函式會傳回 pCount 或較少的專案。
範例
下列代碼段示範如何使用 PeerGraphGetNextItem 列舉物件，並在完成列舉之後結束列舉。
//PeerGraphGetNextItem snippet
// hPeerEnum is a handle to the enumeration obtained from a successful call to PeerGraphEnumConnections,
// PeerGraphEnumNodes, PeerGraphEnumRecords, or PeerGraphSearchRecords.
// Set count equal to the maximum number of items you want returned. To obtain a count of all the items
// in the enumeration, call PeerGraphGetItemCount.
// ppRecord is an array of pointers to PEER_RECORD objects. PEER_CONNECTION_INFO and PEER_NODE_INFO structures
// are also supported.
HRESULT hr = PeerGraphGetNextItem(hPeerEnum, &count, (PVOID *)&ppRecord);
if (FAILED(hr))
{
// Insert your code to handle the error here.
}
else
{
// Free the data obtained by PeerGraphGetNextItem.
PeerGraphFreeData(ppRecord);
}
// If you are done with the enumeration, free the handle to the enumeration.
PeerGraphEndEnumeration(hPeerEnum);
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 搭配 SP1 與適用於Windows XP 的進階網络套件 |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | p2p.h |
| 程式庫 | P2PGraph.lib |
| Dll | P2PGraph.dll |