PeerCollabSetPresenceInfo-Funktion (p2p.h)
Die PeerCollabSetPresenceInfo-Funktion aktualisiert die Anwesenheitsinformationen des Aufrufers für alle Kontakte, die sie beobachten.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetPresenceInfo(
[in] PCPEER_PRESENCE_INFO pcPresenceInfo
);
Parameter
[in] pcPresenceInfo
Zeiger auf eine PEER_PRESENCE_INFO-Struktur , die die neuen Anwesenheitsinformationen enthält, die für die aufrufende Peeranwendung veröffentlicht werden sollen.
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
Kontakte, die die Anwesenheit dieses Peers beobachten, haben ein lokal ausgelöstes PEER_EVENT_PRESENCE_CHANGED Ereignis, das die Änderung der Anwesenheit dieses Peers status signalisiert. Die Anwesenheit eines Peers status kann während der Anmeldung nicht offline festgelegt werden. Standardmäßig ist die Anwesenheit eines Peers status "online", und der beschreibende Text ist null, wenn er sich anmeldet.
Jeder beschreibende Text für anwesenheits- status ist auf 255 Unicode-Zeichen beschränkt.
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 |