Função PeerGraphOpenDirectConnection (p2p.h)
A função PeerGraphOpenDirectConnection permite que um aplicativo estabeleça uma conexão direta com um nó em um grafo par. A conexão só poderá ser feita se o nó ao qual o aplicativo está se conectando tiver assinado o evento PEER_GRAPH_EVENT_DIRECT_CONNECTION . Em seguida, o aplicativo pode enviar dados diretamente para outro nó. Uma chamada para essa função é assíncrona.
Sintaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphOpenDirectConnection(
[in] HGRAPH hGraph,
[in] PCWSTR pwzPeerId,
[in] PPEER_ADDRESS pAddress,
[out] ULONGLONG *pullConnectionId
);
Parâmetros
[in] hGraph
Identificador para um grafo par.
[in] pwzPeerId
Ponteiro para a ID exclusiva de um usuário ou nó ao qual se conectar. Esse parâmetro é usado para identificar um usuário específico porque várias identidades podem ser anexadas ao endereço especificado.
[in] pAddress
Ponteiro para uma estrutura PEER_ADDRESS que contém o endereço do nó ao qual se conectar.
[out] pullConnectionId
Recebe a ID de conexão para a conexão solicitada.
Retornar valor
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 |
|---|---|
|
O identificador do grafo é inválido. |
|
O grafo deve ser inicializado com uma chamada para PeerGraphStartup antes de usar essa função. |
Comentários
Uma chamada para PeerGraphOpenDirectConnection é uma chamada assíncrona. Um evento PEER_GRAPH_EVENT_DIRECT_CONNECTION é disparado para informar a aplicação do sucesso ou da falha da conexão direta. A status real do êxito ou falha da função é fornecida na estrutura PEER_GRAPH_EVENT_DATA.
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 |