Função PeerGraphConnect (p2p.h)
A função PeerGraphConnect tenta fazer uma conexão com um nó especificado em um grafo par. Essa função inicia uma operação assíncrona. O aplicativo de chamada deve aguardar um evento PEER_GRAPH_EVENT_NEIGHBOR_CONNECTION para determinar se a tentativa de conexão foi bem-sucedida.
Sintaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphConnect(
[in] HGRAPH hGraph,
[in] PCWSTR pwzPeerId,
[in] PPEER_ADDRESS pAddress,
[out] ULONGLONG *pullConnectionId
);
Parâmetros
[in] hGraph
Manipule para um grafo par.
[in] pwzPeerId
A ID exclusiva de um par ao qual se conectar em pAddress. Especifique NULL para se conectar a qualquer par escutando em um endereço especificado no mesmo grafo par.
[in] pAddress
Ponteiro para uma estrutura PEER_ADDRESS que identifica um nó ao qual se conectar.
[out] pullConnectionId
Recebe o ponteiro para um ULONGLONG que contém a ID da conexão. Essa ID pode ser usada com as funções de comunicação direta.
Valor retornado
Se a chamada de função for bem-sucedida, o valor retornado será S_OK. Caso contrário, ele retornará um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
|
Um dos parâmetros não é válido. |
|
Não há memória suficiente para executar uma operação especificada. |
|
Já existe uma conexão de vizinho com um nó especificado. |
|
O identificador para um grafo par é inválido. |
|
Um grafo deve ser inicializado com uma chamada para PeerGraphStartup antes de usar essa função. |
Requisitos
| 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 |