PeerGroupSearchRecords-Funktion (p2p.h)

Artikel
08/25/2023

Die PeerGroupSearchRecords-Funktion durchsucht die lokale Peergruppendatenbank nach Datensätzen, die den angegebenen Kriterien entsprechen.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupSearchRecords(
  [in]  HGROUP    hGroup,
  [in]  PCWSTR    pwzCriteria,
  [out] HPEERENUM *phPeerEnum
);

Parameter

[in] hGroup

Handle an die Peergruppe, deren lokale Datenbank durchsucht wird. Dieses Handle wird von der Funktion PeerGroupCreate, PeerGroupOpen oder PeerGroupJoin zurückgegeben. Dieser Parameter ist erforderlich.

[in] pwzCriteria

Zeiger auf eine Unicode-XML-Zeichenfolge, die die Datensatzsuchabfrage enthält. Informationen zum Formulieren einer XML-Abfragezeichenfolge zum Durchsuchen der Peergruppendatensätze-Datenbank finden Sie in der Dokumentation zum Abfrageformat der Datensatzsuche . Dieser Parameter ist erforderlich.

[out] phPeerEnum

Zeiger auf die Enumeration, die die zurückgegebene Liste der Datensätze enthält. Dieses Handle wird an übergeben.
PeerGetNextItem , um die Elemente abzurufen, wobei jedes Element als Zeiger auf eine PEER_RECORD-Struktur dargestellt wird. Anschließend wird PeerEndEnumeration aufgerufen, um den von der Enumeration verwendeten Arbeitsspeicher zurückzugeben. Dieser Parameter ist erforderlich.

Rückgabewert

Gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Funktion einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
E_INVALIDARG	Einer der Parameter ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen.
PEER_E_INVALID_SEARCH	Die XML-Suchabfrage entspricht nicht der Schemaspezifikation der Suchabfrage.

Kryptografiespezifische Fehler können vom Microsoft RSA-Basisanbieter zurückgegeben werden. Diesen Fehlern wird CRYPT_* vorangestellt und in Winerror.h definiert.

Anforderungen


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	P2P.lib
DLL	P2P.dll