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 |
|---|---|
|
Um dos parâmetros não é válido. |
|
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 |