Compartilhar via


Função PeerGroupGetEventData (p2p.h)

A função PeerGroupGetEventData permite que um aplicativo recupere os dados retornados por um evento de agrupamento.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetEventData(
  [in]  HPEEREVENT             hPeerEvent,
  [out] PPEER_GROUP_EVENT_DATA *ppEventData
);

Parâmetros

[in] hPeerEvent

Identificador obtido de uma chamada anterior para PeerGroupRegisterEvent. Este parâmetro é necessário.

[out] ppEventData

Ponteiro para uma estrutura PEER_GROUP_EVENT_DATA que contém dados sobre o evento par. Essa estrutura de dados deve ser liberada após o uso com PeerFreeData. Este parâmetro é necessário.

Valor retornado

Retorna S_OK se a operação for bem-sucedida. Caso contrário, a função retornará um dos valores a seguir.

Código de retorno Descrição
E_INVALIDARG
Um dos parâmetros não é válido.
PEER_S_NO_EVENT_DATA
A chamada foi bem-sucedida, mas não há dados de evento disponíveis.
 

Erros específicos de criptografia podem ser retornados do Provedor Base do Microsoft RSA. Esses erros são prefixados com CRYPT_* e definidos em Winerror.h.

Comentários

Quando ocorre um evento para o qual um par solicitou notificação, o identificador de evento par correspondente é sinalizado. O par chama esse método até que PEER_GROUP_EVENT_DATA estruturas sejam recuperadas. Cada estrutura de dados contém as duas partes principais dos dados a seguir:

  • O registro associado a um evento par.
  • Os dados reais de um evento par.

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 P2P.lib
DLL P2P.dll

Confira também

PEER_GROUP_EVENT_DATA

PeerFreeData

PeerGroupRegisterEvent