PeerGraphEnumRecords, fonction (p2p.h)

Article
03/01/2024

La fonction PeerGraphEnumRecords crée et retourne un handle d’énumération utilisé pour énumérer les enregistrements d’un type spécifique d’enregistrement, d’utilisateur ou des deux. Une énumération fournit une instantané d’enregistrements au moment où une énumération est effectuée.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphEnumRecords(
  [in]  HGRAPH     hGraph,
  [in]  const GUID *pRecordType,
  [in]  PCWSTR     pwzPeerId,
  [out] HPEERENUM  *phPeerEnum
);

Paramètres

[in] hGraph

Gérer vers un graphe d’homologue.

[in] pRecordType

Pointeur vers le type d’enregistrement à énumérer. Spécifiez NULL pour énumérer tous les types d’enregistrements.

[in] pwzPeerId

Pointeur vers une chaîne qui identifie le créateur pour lequel une application demande une énumération. Spécifiez NULL pour énumérer tous les enregistrements.

[out] phPeerEnum

Reçoit un handle pour une énumération. Fournissez le handle à tous les appels à PeerGraphGetNextItem. Lorsqu’un handle n’est pas nécessaire, libérez-le en appelant PeerGraphEndEnumeration.

Valeur retournée

Si l’appel de fonction réussit, la valeur de retour est S_OK. Sinon, il retourne l’une des valeurs suivantes.

Code de retour	Description
E_INVALIDARG	Un paramètre n’est pas valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer une opération spécifiée.
PEER_E_INVALID_GRAPH	Le handle d’un graphe d’homologue n’est pas valide.
PEER_E_NOT_INITIALIZED	Un graphique doit être initialisé avec un appel à PeerGraphStartup avant d’utiliser cette fonction.

Remarques

Si les paramètres pRecordType et pwzPeerId ont la valeur NULL, tous les enregistrements sont retournés.

Pour les tâches d’énumération simples, utilisez la fonction PeerGraphEnumRecords , car elle est plus efficace que la fonction PeerGraphSearchRecords . Pour les tâches complexes d’énumération et de filtrage, telles que les recherches heuristiques de la base de données, utilisez la fonction PeerGraphSearchRecords .

Lorsque PeerGraphGetNextItem est appelé avec le handle que PeerGraphEnumRecords retourne, PeerGraphGetNextItem retourne les données dans la structure PEER_RECORD .

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 réseau avancé pourWindows 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

Voir aussi

PEER_RECORD

PeerGraphEndEnumeration

PeerGraphGetItemCount

PeerGraphGetNextItem

PeerGraphSearchRecords

Partager via