Função PeerGraphListen (p2p.h)

Artigo
03/05/2024

A função PeerGraphListen indica que um grafo par deve começar a escutar conexões de entrada.

Sintaxe

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

Parâmetros

[in] hGraph

Especifica o grafo par no qual escutar.

[in] dwScope

Especifica o escopo IPv6 no qual escutar. Os valores válidos são identificados na tabela a seguir. Para obter mais informações sobre o escopo, consulte Endereços de Link-Local e Site-Local.

Valor	Significado
PEER_GRAPH_SCOPE_GLOBAL	O escopo inclui a Internet.
PEER_GRAPH_SCOPE_SITELOCAL	O escopo é restrito a um site, por exemplo, uma intranet corporativa.
PEER_GRAPH_SCOPE_LINKLOCAL	O escopo é restrito a uma sub-rede local.

[in] dwScopeId

Especifica a ID de escopo IPv6 a ser escutada. Especifique zero (0) para escutar em todas as interfaces do escopo especificado.

Nota A ID de escopo zero (0) não será permitida se dwScope for PEER_GRAPH_SCOPE_SITELOCAL ou PEER_GRAPH_SCOPE_LINKLOCAL.

[in] wPort

Especifica a porta na qual escutar. Especifique zero (0) para usar uma porta dinâmica. Se zero (0) for especificado, use PeerGraphGetNodeInfo para recuperar dados.

Retornar valor

Retorna S_OK se a operação for bem-sucedida. Caso contrário, a função retornará um dos valores identificados na tabela a seguir.

Código de retorno	Descrição
E_INVALIDARG	Um dos parâmetros não é válido.
E_OUTOFMEMORY	Não há memória suficiente para executar a operação especificada.
PEER_E_GRAPH_NOT_READY	O grafo nunca foi sincronizado. Um aplicativo não pode escutar até que o grafo par seja sincronizado.
PEER_E_INVALID_GRAPH	O identificador para o grafo par é inválido.
PEER_E_NOT_INITIALIZED	O grafo deve ser inicializado com uma chamada para PeerGraphStartup antes de usar essa função.

Comentários

Para aceitar conexões diretas, um nó deve assinar o evento PEER_GRAPH_EVENT_DIRECT_CONNECTION .

Antes que essa função possa ser chamada, o aplicativo deve chamar PeerGraphCreate ou PeerGraphOpen.

Nota Se esta for a primeira vez que um grafo par é aberto, todas as chamadas para PeerGraphListen falham até que o nó se conecte e sincronize com o grafo par.

O aplicativo poderá especificar a mesma ID de porta para gráficos pares diferentes, se todos os grafos de pares estiverem no mesmo processo.

Exemplos

O snippet de código a seguir mostra como usar a função 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.
    }

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP2 [somente aplicativos da área de trabalho], Windows XP com SP1 com o Pacote de Rede Avançado paraWindows XP
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	p2p.h
Biblioteca	P2PGraph.lib
DLL	P2PGraph.dll