PeerGraphEnumRecords, fonction (p2p.h)

  • Article

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