PeerGraphSearchRecords-Funktion (p2p.h)

Artikel
08/25/2023

Die Funktion PeerGraphSearchRecords durchsucht das Peerdiagramm nach bestimmten Datensätzen.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphSearchRecords(
  [in]  HGRAPH    hGraph,
  [in]  PCWSTR    pwzCriteria,
  [out] HPEERENUM *phPeerEnum
);

Parameter

[in] hGraph

Handle mit dem Peerdiagramm.

[in] pwzCriteria

Zeiger auf eine XML-Zeichenfolge, die die zu suchenden Datensätze angibt. Informationen zum Formulieren einer XML-Abfragezeichenfolge zum Durchsuchen der Peergraphingdatensätze finden Sie unter Abfrageformat der Datensatzsuche.

[out] phPeerEnum

Handle mit der Enumeration.

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	Einer der Parameter ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den angegebenen Vorgang auszuführen.
PEER_E_INVALID_GRAPH	Das Handle für das Peerdiagramm ist ungültig.
PEER_E_INVALID_SEARCH	Die angegebene Abfrage entspricht nicht dem Suchschema. Weitere Informationen finden Sie unter Abfrageformat der Datensatzsuche .
PEER_E_NOT_INITIALIZED	Das Peerdiagramm muss mit einem Aufruf von PeerGraphStartup initialisiert werden, bevor diese Funktion verwendet wird.

Hinweise

Die PeerGraphEnumRecords-Funktion ist effizienter als die PeerGraphSearchRecords-Funktion .

Wenn PeerGraphGetNextItem mit dem von PeerGraphSearchRecords 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 Advanced Networking Pack forWindows XP
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	p2p.h
Bibliothek	P2PGraph.lib
DLL	P2PGraph.dll