PeerCollabEnumApplicationRegistrationInfo, fonction (p2p.h)

Article
03/04/2024

La fonction PeerCollabEnumApplicationRegistrationInfo obtient le handle d’énumération utilisé pour récupérer les informations d’application homologue.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumApplicationRegistrationInfo(
  [in]  PEER_APPLICATION_REGISTRATION_TYPE registrationType,
  [out] HPEERENUM                          *phPeerEnum
);

Paramètres

[in] registrationType

Valeur PEER_APPLICATION_REGISTRATION_TYPE qui spécifie 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.

[out] phPeerEnum

Pointeur vers un handle d’énumération d’homologue pour les informations d’inscription d’application homologue. Ces données sont obtenues en passant ce handle à PeerGetNextItem.

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.
PEER_E_NOT_INITIALIZED	L’infrastructure homologue Windows n’est pas initialisée. L’appel de la fonction d’initialisation appropriée est obligatoire.

Remarques

Pour obtenir les applications homologues individuelles, passez le handle retourné à PeerGetNextItem. Un tableau de structures PEER_APPLICATION_REGISTRATION_INFO sera retourné. Pour fermer l’énumération et libérer les ressources qui lui sont associées, transmettez ce handle à PeerEndEnumeration. Les éléments individuels retournés par l’énumération doivent être libérés avec PeerFreeData.

Une application est un ensemble de logiciels ou de fonctionnalités logicielles disponibles sur le point de terminaison de l’homologue. Il s’agit généralement de 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’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 auxquelles l’homologue peut participer. Pour désinscrire l’application d’un homologue, appelez PeerCollabUnregisterApplication avec ce GUID.

Les éléments d’informations d’inscription d’application homologue sont retournés en tant que structures PEER_APPLICATION_REGISTRATION_INFO individuelles.

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_INFO

PEER_APPLICATION_REGISTRATION_TYPE

Fonctions de l’API De collaboration entre pairs

PeerCollabUnregisterApplication

Partager via