PeerCollabDeleteObject-Funktion (p2p.h)
Die PeerCollabDeleteObject-Funktion löscht ein Peerobjekt aus dem aufrufenden Endpunkt.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabDeleteObject(
[in] const GUID *pObjectId
);
Parameter
[in] pObjectId
Zeiger auf einen GUID-Wert, der das Peerobjekt eindeutig identifiziert, das vom aufrufenden Endpunkt gelöscht werden soll.
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
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 3216 KB sein.
Vertrauenswürdige Kontakte, die dieses Peerobjekt beobachten, und der Abonnent des "Ich"-Kontakts wird ein PEER_EVENT_OBJECT_CHANGED-Ereignis ausgelöst, das die Änderung dieses Peerobjekts in status signalisiert. PEER_EVENT_MY_OBJECT_CHANGED wird lokal ausgelöst.
Vordefinierte Objekte wie Picture-Objekte können nicht durch Aufrufen dieser API gelöscht 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 |