PeerCollabEnumEndpoints-Funktion (p2p.h)
Die PeerCollabEnumEndpoints-Funktion gibt das Handle an eine Enumeration zurück, die die Endpunkte enthält, die einem bestimmten Peerkontakt zugeordnet sind.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumEndpoints(
[in] PCPEER_CONTACT pcContact,
[out] HPEERENUM *phPeerEnum
);
Parameter
[in] pcContact
Zeiger auf eine PEER_CONTACT Struktur, die die Kontaktinformationen für einen bestimmten Peer enthält. Dieser Parameter darf nicht NULL sein.
[out] phPeerEnum
Zeiger auf ein Handle für den aufgezählten Satz von Endpunkten, die dem angegebenen Peerkontakt zugeordnet sind. Übergeben Sie dieses Handle an PeerGetNextItem , um jedes Element im aufgezählten Satz abzurufen.
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-Peer-Infrastruktur wird nicht initialisiert. Das Aufrufen der entsprechenden Initialisierungsfunktion ist erforderlich. |
|
Für den Vorgang muss der Benutzer angemeldet sein. |
Hinweise
Es wird empfohlen, einen Kontaktdatensatz mithilfe von PeerCollabUpdateContact zu aktualisieren, bevor PeerCollabEnumEndpoints aufgerufen wird. Wenn dies nicht geschieht, kann dies zu einer Rückgabe von E_INVALIDARG führen.
Endpunkte sind nur für Kontakte verfügbar, bei denen fWatch auf true festgelegt ist. Nur Endpunkte, bei denen der "Me"-Kontakt des aufrufenden Peers als vertrauenswürdiger Kontakt gespeichert ist und WatcherPermissions auf zulassen festgelegt ist, sind verfügbar. Ein Kontakt muss auch beim Internet angemeldet werden. Wenn der Kontakt nicht angemeldet ist, wird der Fehler E_INVALIDARG zurückgegeben.
Um die einzelnen Peerendpunkte abzurufen, übergeben Sie das zurückgegebene Handle an PeerGetNextItem. Ein Array von Zeigern auf PEER_ENDPOINT Strukturen wird zurückgegeben. Wenn keine Endpunkte verfügbar sind, wird ein leeres Array zurückgegeben. Um die Enumeration zu schließen und die zugeordneten Ressourcen freizugeben, übergeben Sie dieses Handle an PeerEndEnumeration. Einzelne von der Enumeration zurückgegebene Elemente müssen mit PeerFreeData freigegeben werden.
Der Grenzwert für Verbindungen mit einem einzelnen Kontakt beträgt 50.
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 |