PeerEnumGroups 函式 (p2p.h)
PeerEnumGroups 函式會建立並傳回對等列舉句柄，用來列舉與特定對等識別相關聯的所有對等群組。
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerEnumGroups(
[in] PCWSTR pwzIdentity,
[out] HPEERENUM *phPeerEnum
);
參數
[in] pwzIdentity
指定要列舉群組的對等識別。
[out] phPeerEnum
接收對等列舉的句柄，其中包含指定身分識別所屬的對等群組清單，且每個專案都表示為 PEER_NAME_PAIR 結構的指標。 將此句柄傳遞至 PeerGetNextItem 以擷取專案;完成時，呼叫 PeerEndEnumeration 釋放記憶體。
傳回值
如果函式呼叫成功，傳回值會S_OK。 否則，它會傳回下列其中一個值。
| 傳回碼 | Description |
|---|---|
|
其中一個參數無效。 |
|
記憶體不足，無法執行指定的作業。 |
|
找不到指定的對等識別。 |
備註
一旦應用程式取得列舉句柄，請使用 PeerGetNextItem 和 PeerGetItemCount 來列舉對等群組。
列舉對等群組時， PeerGetNextItem 會傳回指向 PEER_NAME_PAIR 結構的指標陣列。
呼叫 PeerEndEnumeration ，以在不再需要時釋放對等列舉句柄。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 搭配 SP1 與適用於 Windows XP 的進階網络套件 |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | p2p.h |
| 程式庫 | P2P.lib |
| Dll | P2P.dll |