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