Freigeben über


PeerGraphGetNodeInfo-Funktion (p2p.h)

Die Funktion PeerGraphGetNodeInfo ruft Informationen zu einem bestimmten Knoten ab.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphGetNodeInfo(
  [in]  HGRAPH          hGraph,
  [in]  ULONGLONG       ullNodeId,
  [out] PPEER_NODE_INFO *ppNodeInfo
);

Parameter

[in] hGraph

Handle für ein Peerdiagramm.

[in] ullNodeId

Gibt die ID eines Knotens an, zu dem eine Anwendung Informationen empfängt. Geben Sie null (0) an, um Informationen zum lokalen Knoten abzurufen.

[out] ppNodeInfo

Empfängt einen Zeiger auf eine PEER_NODE_INFO-Struktur , die die angeforderten Informationen enthält. Wenn das Handle nicht benötigt wird, geben Sie es durch Aufrufen von PeerGraphFreeData frei.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Funktion einen der folgenden Fehlercodes zurück.

Rückgabecode Beschreibung
E_INVALIDARG
Ein Parameter ist ungültig.
E_OUTOFMEMORY
Es ist nicht genügend Arbeitsspeicher vorhanden, um einen angegebenen Vorgang auszuführen.
PEER_E_INVALID_GRAPH
Das Handle für ein Peerdiagramm ist ungültig.
PEER_E_NOT_INITIALIZED
Ein Peergraph muss mit einem Aufruf von PeerGraphStartup initialisiert werden, bevor diese Funktion verwendet wird.
PEER_E_NODE_NOT_FOUND
Ein angegebener Knoten wurde nicht gefunden.

Hinweise

Es können mehrere Knoten eines Graphen auf einem Computer vorhanden sein. Beispielsweise können mehrere Benutzer das Diagramm auf einem bestimmten Computer verknüpft haben, sodass sich die von PeerGraphGetNodeInfo zurückgegebenen Informationen über jeden Knoten und nicht auf jedem Computer beziehen.

Anforderungen

Anforderung Wert
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 P2PGraph.lib
DLL P2PGraph.dll

Weitere Informationen

PEER_NODE_INFO

PeerGraphFreeData