PeerGraphGetRecord-Funktion (p2p.h)

  • Artikel

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