peerEnumIdentities 函式 (p2p.h)

PeerEnumIdentities 函式會建立並傳回對等列舉句柄，用來列舉屬於特定使用者的所有對等識別。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerEnumIdentities(
  [out] HPEERENUM *phPeerEnum
);

[out] phPeerEnum

接收包含對等識別清單的對等列舉句柄，其中每個專案都表示為 PEER_NAME_PAIR 結構的指標。將此句柄傳遞至 PeerGetNextItem 以擷取專案;完成時，請呼叫 PeerEndEnumeration 以釋放記憶體。

如果函式呼叫成功，傳回值會S_OK。否則，它會傳回下列其中一個值。

傳回碼	Description
E_INVALIDARG	其中一個參數無效。
E_OUTOFMEMORY	記憶體不足，無法執行指定的作業。

一旦應用程式取得對等列舉句柄，請使用 PeerGetNextItem 和 PeerGetItemCount 來列舉對等身分識別。

列舉對等識別時， PeerGetNextItem 會傳回指標陣列，以 PEER_NAME_PAIR 結構。

呼叫 PeerEndEnumeration ，以在不再需要列舉句柄時釋放它。

需求	值
最低支援的用戶端	Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 搭配 SP1 與適用於 Windows XP 的進階網络套件
最低支援的伺服器	都不支援
目標平台	Windows
標頭	p2p.h
程式庫	P2P.lib
Dll	P2P.dll