Função PeerGraphGetEventData (p2p.h)

  • Artigo

A função PeerGraphGetEventData recupera eventos de pares. Um aplicativo chama essa função até que o valor retornado PEER_S_NO_EVENT_DATA seja retornado, o que indica que uma chamada foi bem-sucedida, mas que não há mais eventos pares a serem recuperados.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphGetEventData(
  [in]  HPEEREVENT             hPeerEvent,
  [out] PPEER_GRAPH_EVENT_DATA *ppEventData
);

Parâmetros

[in] hPeerEvent

Identificador de evento par obtido por uma chamada para PeerGraphRegisterEvent.

[out] ppEventData

Recebe um ponteiro para uma estrutura PEER_GRAPH_EVENT_DATA que contém os dados sobre uma notificação de evento. Quando essa estrutura não for necessária, libere-a chamando PeerGraphFreeData.

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
E_INVALIDARG
 Um parâmetro não é válido.
E_OUTOFMEMORY
 Não há memória suficiente para executar uma operação especificada.
PEER_S_NO_EVENT_DATA
 A chamada de função é bem-sucedida, mas não há dados associados a um evento par.
PEER_E_NOT_INITIALIZED
 Um grafo par deve ser inicializado com uma chamada para PeerGraphStartup antes de usar essa função.

Comentários

Os dados de evento par são retornados em uma estrutura PEER_GRAPH_EVENT_DATA . O tipo de estrutura de dados que PEER_GRAPH_EVENT_DATA aponta depende de qual evento é disparado.

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

Confira também

PEER_GRAPH_EVENT_DATA

PeerGraphFreeData

PeerGraphRegisterEvent

PeerGraphUnregisterEvent