peerEnumIdentities 函式 (p2p.h)
PeerEnumIdentities 函式會建立並傳回對等列舉句柄,用來列舉屬於特定使用者的所有對等識別。
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerEnumIdentities(
[out] HPEERENUM *phPeerEnum
);
參數
[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 |