PeerGraphEnumRecords-Funktion (p2p.h)

Artikel
08/25/2023

Die PeerGraphEnumRecords-Funktion erstellt und gibt ein Enumerationshandle zurück, das zum Aufzählen von Datensätzen eines bestimmten Datensatztyps, benutzers oder beides verwendet wird. Eine -Enumeration stellt eine Momentaufnahme von Datensätzen zum Zeitpunkt der Aufzählung bereit.

Syntax

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

Parameter

[in] hGraph

Handle für ein Peerdiagramm.

[in] pRecordType

Zeiger auf den Typ des aufzulistenden Datensatzes. Geben Sie NULL an, um alle Datensatztypen aufzulisten.

[in] pwzPeerId

Zeiger auf eine Zeichenfolge, die den Ersteller identifiziert, für den eine Anwendung eine Enumeration anfordert. Geben Sie NULL an, um alle Datensätze aufzulisten.

[out] phPeerEnum

Empfängt ein Handle für eine Enumeration. Geben Sie das Handle für alle Aufrufe von PeerGraphGetNextItem an. Wenn ein Handle nicht benötigt wird, geben Sie es frei, indem Sie PeerGraphEndEnumeration aufrufen.

Rückgabewert

Wenn der Funktionsaufruf erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls wird einer der folgenden Werte zurückgegeben.

Rückgabecode	Beschreibung
E_INVALIDARG	Ein Parameter ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um einen angegebenen Vorgang auszuführen.
PEER_E_INVALID_GRAPH	Das Handle für ein Peerdiagramm ist ungültig.
PEER_E_NOT_INITIALIZED	Ein Graph muss mit einem Aufruf von PeerGraphStartup initialisiert werden, bevor diese Funktion verwendet wird.

Hinweise

Wenn sowohl die Parameter pRecordType als auch pwzPeerIdNULL sind, werden alle Datensätze zurückgegeben.

Verwenden Sie für einfache Enumerationsaufgaben die Funktion PeerGraphEnumRecords , da sie effizienter ist als die PeerGraphSearchRecords-Funktion . Verwenden Sie für komplexe Enumerations- und Filteraufgaben wie heuristische Suchvorgänge der Datenbank die Funktion PeerGraphSearchRecords .

Wenn PeerGraphGetNextItem mit dem Von PeerGraphEnumRecords zurückgegebenen Handle aufgerufen wird, gibt PeerGraphGetNextItem die Daten in der PEER_RECORD-Struktur zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Erweiterten Netzwerkpaket fürWindows XP
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	p2p.h
Bibliothek	P2PGraph.lib
DLL	P2PGraph.dll