PeerCollabGetPresenceInfo-Funktion (p2p.h)
Die Funktion PeerCollabGetPresenceInfo ruft die Anwesenheitsinformationen für den Endpunkt ab, der einem bestimmten Kontakt zugeordnet ist.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabGetPresenceInfo(
[in] PCPEER_ENDPOINT pcEndpoint,
[out] PPEER_PRESENCE_INFO *ppPresenceInfo
);
Parameter
[in] pcEndpoint
Zeiger auf eine PEER_ENDPOINT Struktur, die den spezifischen Endpunkt enthält, der dem in pcContact angegebenen Kontakt zugeordnet ist, für den Anwesenheitsinformationen zurückgegeben werden müssen.
[out] ppPresenceInfo
Zeiger auf die Adresse der PEER_PRESENCE_INFO Struktur, die die angeforderten Anwesenheitsdaten für den angegebenen Endpunkt 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 Anwendung hat peerCollabStartup zuvor nicht aufgerufen. |
|
Die Anwesenheitsinformationen für den angegebenen Endpunkt wurden im Peerzusammenarbeitsnetzwerk nicht gefunden. |
Hinweise
So rufen Sie ein Peerobjekt erfolgreich ab:
- 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.
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 |