PeerGroupGetRecord-Funktion (p2p.h)

Artikel
08/25/2023

Die PeerGroupGetRecord-Funktion ruft einen bestimmten Gruppendatensatz ab.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetRecord(
  [in]  HGROUP       hGroup,
  [in]  const GUID   *pRecordId,
  [out] PPEER_RECORD *ppRecord
);

Parameter

[in] hGroup

Handle für eine Gruppe, die einen bestimmten Datensatz enthält. Dieses Handle wird von der Funktion PeerGroupCreate, PeerGroupOpen oder PeerGroupJoin zurückgegeben. Dieser Parameter ist erforderlich.

[in] pRecordId

Gibt den GUID-Wert an, der einen erforderlichen Datensatz innerhalb einer Peergruppe eindeutig identifiziert. Dieser Parameter ist erforderlich.

[out] ppRecord

Zeiger auf die Adresse einer PEER_RECORD-Struktur , die einen zurückgegebenen Datensatz enthält. Diese Struktur wird freigegeben, indem der Zeiger an PeerFreeData übergeben wird. 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 vorhanden, um den angegebenen Vorgang auszuführen.
PEER_E_GROUP_NOT_READY	Die Peergruppe befindet sich nicht in einem Zustand, in dem Gruppendatensätze abgerufen werden können. Beispielsweise wird PeerGroupJoin aufgerufen, aber die Synchronisierung mit der Peergruppendatenbank wurde nicht abgeschlossen.
PEER_E_INVALID_GROUP	Das Handle für eine Peergruppe ist ungültig.
PEER_E_RECORD_NOT_FOUND	Ein Datensatz, der der angegebenen ID entspricht, kann nicht in einer Peergruppendatenbank gefunden werden.

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