PeerGraphCreate, fonction (p2p.h)

Article
03/04/2024

La fonction PeerGraphCreate crée un graphique homologue. Une application peut spécifier des informations sur un graphique d’homologue et le type de sécurité utilisé par un graphique homologue. Un handle à un graphique homologue est retourné, mais aucune connexion réseau n’est établie.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphCreate(
  [in]  PPEER_GRAPH_PROPERTIES   pGraphProperties,
  [in]  PCWSTR                   pwzDatabaseName,
  [in]  PPEER_SECURITY_INTERFACE pSecurityInterface,
  [out] HGRAPH                   *phGraph
);

Paramètres

[in] pGraphProperties

Toutes les propriétés d’un graphique homologue dans la structure PEER_GRAPH_PROPERTIES .

[in] pwzDatabaseName

Nom d’une base de données d’enregistrements à associer à un graphique homologue lors de sa création. Le nom de la base de données d’enregistrements doit être un nom de fichier valide. N’incluez pas de chemin d’accès avec le nom de fichier. Pour obtenir la liste complète des règles relatives aux noms de fichiers, consultez l’élément Nommage d’un fichier dans la liste des Reference_Links graphes.

[in] pSecurityInterface

Informations sur un fournisseur de sécurité pour un graphique homologue dans la structure PEER_SECURITY_INTERFACE .

[out] phGraph

Reçoit un handle pour le graphique d’homologue qui est créé. Lorsque ce handle n’est plus nécessaire, libérez-le en appelant PeerGraphClose.

Valeur retournée

Retourne S_OK si l’opération réussit. Sinon, la fonction retourne l’une des valeurs suivantes.

Code de retour	Description
E_INVALIDARG	L’un des paramètres n’est pas valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer une opération spécifiée.
PEER_E_DUPLICATE_GRAPH	Base de données avec un ID de graphe d’homologue spécifié qui existe déjà.
PEER_E_NOT_INITIALIZED	Le graphe homologue doit être initialisé avec un appel à PeerGraphStartup avant d’utiliser cette fonction.

Remarques

Si vous développez votre propre fournisseur de services de sécurité (SSP), votre application ne doit pas appeler l’API Peer Graphing pour accéder aux données de la base de données de graphiques d’homologues, car cela peut entraîner une situation d’interblocage. Au lieu de cela, l’application doit utiliser une copie mise en cache des informations. La copie mise en cache n’est pas créée par l’API Peer Graphing. L’application doit fournir un mécanisme de mise en cache de ces données.

Une fois PeerGraphCreate appelé, l’application peut s’abonner aux événements avant d’appeler PeerGraphListen.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec le pack de mise en réseau avancé pour Windows XP
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	p2p.h
Bibliothèque	P2PGraph.lib
DLL	P2PGraph.dll