PeerCollabEnumObjects-Funktion (p2p.h)
Die PeerCollabEnumObjects-Funktion gibt das Handle an eine Enumeration zurück, die die Peerobjekte enthält, die dem Endpunkt eines bestimmten Peers zugeordnet sind.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumObjects(
[in] PCPEER_ENDPOINT pcEndpoint,
[in, optional] const GUID *pObjectId,
[out] HPEERENUM *phPeerEnum
);
Parameter
[in] pcEndpoint
Zeiger auf eine PEER_ENDPOINT-Struktur , die die Endpunktinformationen für einen Peer enthält, dessen Objekte aufgelistet werden.
Wenn dieser Parameter NULL ist, werden die veröffentlichten Objekte der Kontakte des lokalen Peers zurückgegeben.
[in, optional] pObjectId
Zeiger auf einen GUID-Wert, der ein Peerobjekt mit dem angegebenen Peer eindeutig identifiziert. Wenn dieser Parameter angegeben wird, wird nur das Peerobjekt zurückgegeben, das dieser GUID entspricht.
[out] phPeerEnum
Zeiger auf das Handle für den aufgezählten Satz von Peerobjekten, die der in pObjectId zurückgegebenen GUID entsprechen. Ü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
Peerobjekte sind Laufzeitdatenelemente, die einer bestimmten Anwendung zugeordnet sind, z. B. einem Bild, einem Avatar, einem Zertifikat oder einer bestimmten Beschreibung. Jedes Peerobjekt muss kleiner als 16 KB sein.
PeerCollabEnumObjects gibt alle Objekte zurück, die für den lokalen Peer veröffentlicht wurden. Die Objekte können von mehreren Anwendungen veröffentlicht werden.
Um die einzelnen Peerobjekte abzurufen, übergeben Sie das zurückgegebene Handle an PeerGetNextItem. Die Peerobjekte werden als Array von Zeigern auf die PEER_OBJECT-Strukturen zurückgegeben. Wenn der Endpunkt keine Objekte veröffentlicht, 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.
So erhalten Sie ein Peerobjekt erfolgreich:
- Der Endpunkt muss zuvor durch Aufrufen von PeerCollabEnumEndpoints abgerufen worden sein.
- Der lokale Peer muss den Endpunkt durch Aufrufen von PeerCollabSubscribeEndpointData abonniert haben.
- Die Endpunktdaten müssen aktualisiert werden, indem PeerCollabRefreshEndpointData erfolgreich aufgerufen wird.
Wenn der Benutzer ein Bild veröffentlicht, kann das Bild abgerufen werden, indem das entsprechende Objekt abgerufen wird. Die GUID für das Bildobjekt ist PEER_COLLAB_OBJECTID_USER_PICTURE.
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 |