PeerCollabRegisterApplication, fonction (p2p.h)

La fonction PeerCollabRegisterApplication inscrit une application auprès de l’ordinateur local afin qu’elle puisse être lancée dans une activité de collaboration d’homologue.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRegisterApplication(
  [in] PCPEER_APPLICATION_REGISTRATION_INFO pcApplication,
  [in] PEER_APPLICATION_REGISTRATION_TYPE   registrationType
);

Paramètres

[in] pcApplication

Pointeur vers une structure de PEER_APPLICATION_REGISTRATION_INFO qui contient l’UUID de l’ensemble de fonctionnalités d’application de l’homologue, ainsi que toutes les données supplémentaires spécifiques à l’homologue.

[in] registrationType

Valeur PEER_APPLICATION_REGISTRATION_TYPE qui indique si l’application de l’homologue est inscrite auprès de l’utilisateur actuel ou de tous les utilisateurs de l’ordinateur de l’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
E_OUTOFMEMORY	La mémoire est insuffisante pour prendre en charge cette opération.
E_INVALIDARG	L’un des arguments n’est pas valide.

Remarques

Une application est un ensemble de logiciels ou de fonctionnalités logicielles disponibles sur le point de terminaison de l’homologue. Généralement, cela fait référence aux packages logiciels qui prennent en charge les activités de mise en réseau des pairs, comme les jeux ou d’autres applications collaboratives.

L’infrastructure de collaboration peut recevoir des invitations d’application à partir de contacts approuvés ou de « Personnes près de moi », qui sont basés sur l’étendue avec laquelle l’infrastructure de collaboration est connectée à l’aide de PeerCollabSignin.

L’application d’un homologue a un GUID représentant une seule application spécifique. Lorsqu’une application est inscrite pour un homologue, ce GUID et l’application correspondante peuvent être mis à la disposition de tous les contacts approuvés de l’homologue, indiquant les activités à laquelle l’homologue peut participer. Pour désinscrire l’application d’un homologue, appelez PeerCollabUnregisterApplication avec ce GUID.

Lors de l’inscription d’une application, il est recommandé aux développeurs de spécifier un chemin relatif, tel que %ProgramFiles%, au lieu d’un chemin absolu. Cela empêche l’échec de l’application en raison d’une modification de l’emplacement des fichiers d’application. Par exemple, si le répertoire C :\ProgramFiles est déplacé vers E :\.

Seules les applications locales de l’ordinateur peuvent être inscrites. Il n’est pas possible de s’inscrire lorsque le chemin d’accès exécutable d’une application se trouve sur un partage réseau tel qu’un chemin UNC ou un lecteur réseau mappé localement.

Les applications peuvent être inscrites dans les étendues « ALL_USERS » et « CURRENT_USER ». Dans le cas où une application est inscrite dans les deux étendues simultanément, une application inscrite dans l’étendue « CURRENT_USER » est prioritaire sur une application inscrite dans l’étendue « ALL_USERS ». Il est important de noter que pour s’inscrire au type d’inscription « ALL_USERS », l’appelant doit fonctionner avec des privilèges administratifs.

Le nombre maximal d’applications pouvant être inscrites pour un registrationType spécifique est de 64.

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

Voir aussi

PEER_APPLICATION_REGISTRATION_TYPE

Fonctions de l’API De collaboration d’homologue

PeerCollabUnregisterApplication