Função PeerGraphRegisterEvent (p2p.h)

Artigo
03/13/2024

A função PeerGraphRegisterEvent registra a solicitação de um par para ser notificada sobre as alterações associadas a um grafo par e um tipo de evento.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphRegisterEvent(
  [in]  HGRAPH                        hGraph,
  [in]  HANDLE                        hEvent,
  [in]  ULONG                         cEventRegistrations,
  [in]  PEER_GRAPH_EVENT_REGISTRATION *pEventRegistrations,
  [out] HPEEREVENT                    *phPeerEvent
);

Parâmetros

[in] hGraph

Manipule para o grafo par.

[in] hEvent

Identificador criado por CreateEvent no qual o aplicativo é sinalizado quando um evento é disparado. Quando um aplicativo é sinalizado, ele deve chamar PeerGraphGetEventData para recuperar eventos até que PEER_S_NO_EVENT_DATA retornado.

[in] cEventRegistrations

Especifica o número de estruturas de PEER_GRAPH_EVENT_REGISTRATION em pEventRegistrations.

[in] pEventRegistrations

Aponta para uma matriz de estruturas de PEER_GRAPH_EVENT_REGISTRATION que especificam para quais eventos o aplicativo solicita notificações.

[out] phPeerEvent

Recebe um identificador HPEEREVENT . Esse identificador deve ser usado ao chamar PeerGraphUnregisterEvent para parar de receber notificações.

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 dos parâmetros não é válido.
E_OUTOFMEMORY	Não há memória suficiente para executar a operação especificada.
PEER_E_INVALID_GRAPH	O identificador para o grafo par é inválido.
PEER_E_NOT_INITIALIZED	O grafo par deve ser inicializado com uma chamada para PeerGraphStartup antes de usar essa função.

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_REGISTRATION

PeerGraphGetEventData

PeerGraphUnregisterEvent

Compartilhar via