Função PeerGraphListen (p2p.h)
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.
[in] dwScopeId
Especifica a ID de escopo IPv6 a ser escutada. Especifique zero (0) para escutar em todas as interfaces do escopo especificado.
[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 |
---|---|
|
Um dos parâmetros não é válido. |
|
Não há memória suficiente para executar a operação especificada. |
|
O grafo nunca foi sincronizado. Um aplicativo não pode escutar até que o grafo par seja sincronizado. |
|
O identificador para o grafo par é inválido. |
|
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.
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 |