PeerCollabEnumPeopleNearMe-Funktion (p2p.h)
Die Funktion PeerCollabEnumPeopleNearMe gibt ein Handle an einen aufgezählten Satz zurück, der alle Endpunkte des Peerzusammenarbeitsnetzwerks "Personen in meiner Nähe" enthält, die derzeit im Subnetz des aufrufenden Peers verfügbar sind.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumPeopleNearMe(
[out] HPEERENUM *phPeerEnum
);
Parameter
[out] phPeerEnum
Zeiger auf ein Handle einer aufgezählten Gruppe, die alle Endpunkte des Peerzusammenarbeitsnetzwerks "Personen in meiner Nähe" enthält, die derzeit im Subnetz des aufrufenden Peers verfügbar sind.
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 |
|---|---|
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um diesen Vorgang zu unterstützen. |
|
Eines der Argumente ist ungültig. |
|
Die Windows-Peerinfrastruktur wird nicht initialisiert. Der Aufruf der relevanten Initialisierungsfunktion ist erforderlich. |
|
Für den Vorgang muss der Benutzer angemeldet sein. |
Hinweise
Übergeben Sie das zurückgegebene Handle an PeerGetNextItem, um die einzelnen Peerkontakte "Personen in meiner Nähe" abzurufen. Ein Array von Zeigern auf die PEER_PEOPLE_NEAR_ME Strukturen werden zurückgegeben. 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 |