PeerCollabSetObject, fonction (p2p.h)
La fonction PeerCollabSetObject crée ou met à jour un objet de données homologue utilisé dans un réseau de collaboration d’homologues.
Syntaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetObject(
[in] PCPEER_OBJECT pcObject
);
Paramètres
[in] pcObject
Pointeur vers une structure PEER_OBJECT qui contient l’objet homologue sur le réseau de collaboration homologue.
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 objets homologues sont des éléments de données d’exécution associés à une application particulière, comme une image, un avatar, un certificat ou une description spécifique. Chaque objet homologue doit avoir une taille inférieure à 16 Ko et ne peut pas être égal à 0.
Si un objet est déjà publié, PeerCollabSetObject met à jour les données d’objet existantes. La dernière application qui met à jour l’objet prend possession de l’objet. Par conséquent, si l’application est arrêtée, l’objet est supprimé.
Si le status « publié » d’un objet est supprimé en raison de la déconnexion plutôt que de la fermeture de l’application associée, l’application est responsable de la publication de l’objet la prochaine fois que l’utilisateur se connecte.
Les contacts approuvés qui surveillent cet objet homologue auront un événement PEER_EVENT_OBJECT_CHANGED déclenché localement, signalant le changement de cet objet homologue dans status.
PeerCollabSetObject peut être utilisé pour publier au maximum 128 objets.
Il existe un objet avec un GUID donné publié à un moment donné.
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 |