PeerGraphListen-Funktion (p2p.h)

Artikel
03/01/2024

Die PeerGraphListen-Funktion gibt an, dass ein Peergraph mit dem Lauschen auf eingehende Verbindungen beginnen soll.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphListen(
  [in] HGRAPH hGraph,
  [in] DWORD  dwScope,
  [in] DWORD  dwScopeId,
  [in] WORD   wPort
);

Parameter

[in] hGraph

Gibt das Peerdiagramm an, auf das überwacht werden soll.

[in] dwScope

Gibt den zu überwachenden IPv6-Bereich an. Gültige Werte werden in der folgenden Tabelle angegeben. Weitere Informationen zum Bereich finden Sie unter Link-Local und Site-Local Adressen.

Wert	Bedeutung
PEER_GRAPH_SCOPE_GLOBAL	Der Bereich umfasst das Internet.
PEER_GRAPH_SCOPE_SITELOCAL	Der Bereich ist auf eine Website beschränkt, z. B. ein Unternehmensintranet.
PEER_GRAPH_SCOPE_LINKLOCAL	Der Bereich ist auf ein lokales Subnetz beschränkt.

[in] dwScopeId

Gibt die zu überwachende IPv6-Bereichs-ID an. Geben Sie null (0) an, um an allen Schnittstellen des angegebenen Bereichs zu lauschen.

Hinweis Die Bereichs-ID null (0) ist nicht zulässig, wenn dwScopePEER_GRAPH_SCOPE_SITELOCAL oder PEER_GRAPH_SCOPE_LINKLOCAL ist.

[in] wPort

Gibt den Port an, an dem überwacht werden soll. Geben Sie null (0) an, um einen dynamischen Port zu verwenden. Wenn null (0) angegeben ist, verwenden Sie PeerGraphGetNodeInfo , um Daten abzurufen.

Rückgabewert

Gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Funktion einen der in der folgenden Tabelle angegebenen Werte zurück.

Rückgabecode	Beschreibung
E_INVALIDARG	Einer der Parameter ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den angegebenen Vorgang auszuführen.
PEER_E_GRAPH_NOT_READY	Das Diagramm wurde nie synchronisiert. Eine Anwendung kann erst lauschen, wenn das Peerdiagramm synchronisiert wurde.
PEER_E_INVALID_GRAPH	Das Handle für das Peerdiagramm ist ungültig.
PEER_E_NOT_INITIALIZED	Der Graph muss mit einem Aufruf von PeerGraphStartup initialisiert werden, bevor diese Funktion verwendet wird.

Hinweise

Um direkte Verbindungen akzeptieren zu können, muss ein Knoten das PEER_GRAPH_EVENT_DIRECT_CONNECTION-Ereignis abonnieren.

Bevor diese Funktion aufgerufen werden kann, muss die Anwendung PeerGraphCreate oder PeerGraphOpen aufrufen.

Hinweis Wenn ein Peergraph zum ersten Mal geöffnet wird, schlagen alle Aufrufe von PeerGraphListen fehl, bis der Knoten eine Verbindung mit dem Peergraph herstellt und mit diesem synchronisiert wird.

Die Anwendung kann dieselbe Port-ID für verschiedene Peergraphen angeben, wenn sich alle Peergraphen im selben Prozess befinden.

Beispiele

Der folgende Codeausschnitt veranschaulicht die Verwendung der Funktion PeerGraphListen .

    // g_hGraph is a handle to the Graph obtained from a previous successful call to PeerGraphCreate or PeerGraphOpen.
    // dwScope should be set to the same scope used to create the graph.  This example assumes the graph was created in the Global scope.
    // g_usPort is the port to use for Graphing.  Use zero to obtain a port dynamically.
    HRESULT hr = PeerGraphListen(g_hGraph, PEER_GRAPH_SCOPE_GLOBAL, 0, g_usPort);

    if (FAILED(hr))
    {
        // Insert your code to handle the error here.
    }
    else
    {
        // Insert your application specific code here.
    }

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

Freigeben über