Freigeben über


PeerCollabEnumContacts-Funktion (p2p.h)

Die PeerCollabEnumContacts-Funktion gibt ein Handle an einen aufgezählten Satz zurück, der alle derzeit auf dem aufrufenden Peer verfügbaren Netzwerkkontakte für die Peerzusammenarbeit enthält.

Syntax

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

Parameter

[out] phPeerEnum

Handle an einen aufgezählten Satz, der alle derzeit auf dem aufrufenden Peer verfügbaren Netzwerkkontakte für die Zusammenarbeit enthält, mit Ausnahme des "Ich"-Kontakts.

Rückgabewert

Gibt S_OK zurück, wenn die Funktion erfolgreich ist. Andernfalls gibt die Funktion einen der folgenden Werte zurück.

Rückgabecode Beschreibung
E_OUTOFMEMORY
Es ist nicht genügend Arbeitsspeicher vorhanden, um diesen Vorgang zu unterstützen.
E_INVALIDARG
Eines der Argumente ist ungültig.
PEER_E_NOT_INITIALIZED
Die Windows-Peerinfrastruktur wird nicht initialisiert. Der Aufruf der relevanten Initialisierungsfunktion ist erforderlich.

Hinweise

Um die einzelnen Peerkontakte abzurufen, übergeben Sie das zurückgegebene Handle an PEER_CONTACT Strukturen zurückgegeben werden. Um die Enumeration zu schließen und die zugeordneten Ressourcen freizugeben, übergeben Sie dieses Handle an PeerEndEnumeration. Einzelne elemente, die von der Enumeration zurückgegeben werden, müssen mit PeerFreeData freigegeben werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile p2p.h
Bibliothek P2P.lib
DLL P2P.dll

Weitere Informationen

Peerzusammenarbeits-API-Funktionen