PeerCollabSetObject-Funktion (p2p.h)
Die PeerCollabSetObject-Funktion erstellt oder aktualisiert ein Peerdatenobjekt, das in einem Peerzusammenarbeitsnetzwerk verwendet wird.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetObject(
[in] PCPEER_OBJECT pcObject
);
Parameter
[in] pcObject
Zeiger auf eine PEER_OBJECT-Struktur , die das Peerobjekt im Peerzusammenarbeitsnetzwerk enthält.
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 und darf nicht 0 sein.
Wenn ein Objekt bereits veröffentlicht wurde, aktualisiert PeerCollabSetObject die vorhandenen Objektdaten. Die letzte Anwendung, die das Objekt aktualisiert, übernimmt den Besitz des Objekts. Wenn die Anwendung beendet wird, wird das Objekt daher gelöscht.
Wenn die "veröffentlichte" status eines Objekts aufgrund der Abmeldung und nicht aufgrund des Schließens der zugehörigen Anwendung entfernt wird, ist die Anwendung für die Veröffentlichung des Objekts verantwortlich, wenn sich der Benutzer das nächste Mal anmeldet.
Vertrauenswürdige Kontakte, die dieses Peerobjekt beobachten, haben ein lokal ausgelöstes PEER_EVENT_OBJECT_CHANGED Ereignis, das die Änderung dieses Peerobjekts in status signalisiert.
PeerCollabSetObject kann verwendet werden, um maximal 128 Objekte zu veröffentlichen.
Es gibt ein Objekt mit einer bestimmten GUID , die zu einem bestimmten Zeitpunkt veröffentlicht wird.
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 |