Freigeben über


PeerGraphSearchRecords-Funktion (p2p.h)

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

Weitere Informationen

PEER_RECORD

PeerGraphEndEnumeration

PeerGraphEnumRecords

PeerGraphGetItemCount

PeerGraphGetNextItem