Freigeben über


PeerGraphEnumConnections-Funktion (p2p.h)

Die PeerGraphEnumConnections-Funktion erstellt und gibt ein Enumerationshandle zurück, das zum Auflisten der Verbindungen eines lokalen Knotens verwendet wird.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphEnumConnections(
  [in]  HGRAPH    hGraph,
  [in]  DWORD     dwFlags,
  [out] HPEERENUM *phPeerEnum
);

Parameter

[in] hGraph

Handle mit einem Peerdiagramm.

[in] dwFlags

Der Typ der aufzulistenden Verbindung. Dieser Parameter ist erforderlich. Gültige Werte werden von PEER_CONNECTION_FLAGS angegeben.

[out] phPeerEnum

Empfängt ein Handle für eine Enumeration. Verwenden Sie PeerGraphGetNextItem , um die tatsächlichen Verbindungsinformationen abzurufen. Wenn dieses Handle nicht erforderlich ist, geben Sie es frei, indem Sie PeerGraphEndEnumeration 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.
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
Das Peerdiagramm muss mit einem Aufruf von PeerGraphStartup initialisiert werden, bevor diese Funktion verwendet wird.

Hinweise

Wenn PeerGraphGetNextItem mit dem von PeerGraphEnumConnections zurückgegebenen Enumerationshandle aufgerufen wird, gibt PeerGraphGetNextItem eine PEER_CONNECTION_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_CONNECTION_INFO

PeerGraphEndEnumeration

PeerGraphGetItemCount

PeerGraphGetNextItem