PeerGraphGetRecord-Funktion (p2p.h)

Artikel
03/01/2024

Die PeerGraphGetRecord-Funktion ruft einen bestimmten Datensatz basierend auf der angegebenen Datensatz-ID ab. Der zurückgegebene Datensatz sollte durch Aufrufen von PeerGraphFreeData freigegeben werden.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphGetRecord(
  [in]  HGRAPH       hGraph,
  [in]  const GUID   *pRecordId,
  [out] PPEER_RECORD *ppRecord
);

Parameter

[in] hGraph

Handle mit dem Peerdiagramm.

[in] pRecordId

Zeiger auf die abzurufende Datensatz-ID.

[out] ppRecord

Empfängt den angeforderten Datensatz. Wenn diese Struktur nicht mehr erforderlich ist, geben Sie sie frei, indem Sie PeerGraphFreeData aufrufen.

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.
PEER_E_GRAPH_NOT_READY	Das Peerdiagramm wurde nie synchronisiert. Datensätze können erst abgerufen werden, wenn das Peerdiagramm synchronisiert wurde.
PEER_E_INVALID_GRAPH	Das Handle für das Peerdiagramm ist ungültig.
PEER_E_NOT_INITIALIZED	Das Peerdiagramm muss mit einem Aufruf von PeerGraphStartup initialisiert werden, bevor diese Funktion verwendet wird.
PEER_E_RECORD_NOT_FOUND	Der angegebene Datensatz wurde nicht gefunden.

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

PeerGraphFreeData

Freigeben über