PeerGroupSearchRecords-Funktion (p2p.h)
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 |
|---|---|
|
Einer der Parameter ist ungültig. |
|
Es ist nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen. |
|
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 |