PeerCollabSetPresenceInfo, fonction (p2p.h)
La fonction PeerCollabSetPresenceInfo met à jour les informations de présence de l’appelant à tous les contacts qui le regardent.
Syntaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetPresenceInfo(
[in] PCPEER_PRESENCE_INFO pcPresenceInfo
);
Paramètres
[in] pcPresenceInfo
Pointeur vers une structure PEER_PRESENCE_INFO qui contient les nouvelles informations de présence à publier pour l’application homologue appelante.
Valeur retournée
Retourne S_OK si la fonction réussit. Sinon, la fonction retourne l’une des valeurs suivantes.
| Code de retour | Description |
|---|---|
|
La mémoire est insuffisante pour prendre en charge cette opération. |
|
L’un des arguments n’est pas valide. |
|
L’infrastructure homologue Windows n’est pas initialisée. L’appel de la fonction d’initialisation appropriée est obligatoire. |
|
L’opération nécessite que l’utilisateur soit connecté. |
Remarques
Les contacts qui surveillent la présence de cet homologue auront un événement PEER_EVENT_PRESENCE_CHANGED déclenché localement qui signale le changement de présence de cet homologue status. La présence d’un homologue status ne peut pas être définie sur hors connexion lors de la connexion. Par défaut, la présence d’un homologue status est « en ligne » et le texte descriptif est NULL lors de la connexion.
Tout texte descriptif pour les status de présence est limité à 255 caractères Unicode.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Aucun pris en charge |
| Plateforme cible | Windows |
| En-tête | p2p.h |
| Bibliothèque | P2P.lib |
| DLL | P2P.dll |