PeerGraphEnumNodes-Funktion (p2p.h)

Artikel
08/25/2023

Die PeerGraphEnumNodes-Funktion erstellt und gibt ein Enumerationshandle zurück, das zum Auflisten der Knoten in einem Peerdiagramm verwendet wird. Die Enumeration stellt eine Momentaufnahme eines Peerdiagramms zum Zeitpunkt der Aufzählung bereit. Abhängig von der Richtlinie eines Peerdiagramms und wenn Knoten keine Anwesenheitsinformationen veröffentlichen, gibt eine Enumeration einige Knoten, die mit einem Peerdiagramm verbunden sind, nicht zurück.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphEnumNodes(
  [in]  HGRAPH    hGraph,
  [in]  PCWSTR    pwzPeerId,
  [out] HPEERENUM *phPeerEnum
);

Parameter

[in] hGraph

Handle mit einem Peerdiagramm.

[in] pwzPeerId

Die Peer-ID zum Abrufen einer Knotenaufzählung. Geben Sie NULL an, um alle Knoten in einem Peerdiagramm zurückzugeben.

[out] phPeerEnum

Empfängt ein Handle für eine Enumeration. Verwenden Sie PeerGraphGetNextItem , um die tatsächlichen Knoteninformationen abzurufen. Wenn dieses Handle nicht benötigt wird, geben Sie es frei, indem Sie PeerGraphEndEnumeration aufrufen.

Rückgabewert

Wenn ein Funktionsaufruf erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls wird einer der folgenden Werte zurückgegeben.

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_NOT_READY	Ein Peerdiagramm ist nicht vollständig synchronisiert, und die Knoten können nicht aufgelistet werden.
PEER_E_PRESENCE_DISABLED	Ein Peerdiagramm erfordert keine Anwesenheitsinformationen. Daher können die Knoten nicht aufgelistet werden.

Hinweise

Wenn PeerGraphGetNextItem mit dem Von PeerGraphEnumNodes zurückgegebenen Handle aufgerufen wird, gibt PeerGraphGetNextItem die Daten in der PEER_NODE_INFO-Struktur zurück.

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_NODE_INFO

PeerGraphEndEnumeration

PeerGraphGetItemCount

PeerGraphGetNextItem

Freigeben über