Função PeerGroupRegisterEvent (p2p.h)

Artigo
03/05/2024

A função PeerGroupRegisterEvent registra um par para eventos específicos do grupo de pares.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupRegisterEvent(
  [in]  HGROUP                        hGroup,
  [in]  HANDLE                        hEvent,
  [in]  DWORD                         cEventRegistration,
  [in]  PEER_GROUP_EVENT_REGISTRATION *pEventRegistrations,
  [out] HPEEREVENT                    *phPeerEvent
);

Parâmetros

[in] hGroup

Identificador do grupo de pares no qual monitorar os eventos de pares específicos. Esse identificador é retornado pela função PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Este parâmetro é necessário.

[in] hEvent

Ponteiro para um identificador de evento do Windows, que é sinalizado quando um evento par é acionado. Quando esse identificador é sinalizado, o par deve chamar PeerGroupGetEventData até que a função retorne PEER_S_NO_EVENT_DATA. Este parâmetro é necessário.

[in] cEventRegistration

Contém o número de estruturas de PEER_GROUP_EVENT_REGISTRATION listadas em pEventRegistrations. Este parâmetro é necessário.

[in] pEventRegistrations

Ponteiro para uma lista de estruturas de PEER_GROUP_EVENT_REGISTRATION que contém os tipos de evento par para os quais o registro ocorre. Este parâmetro é necessário.

[out] phPeerEvent

Ponteiro para o identificador HPEEREVENT retornado. Um par pode cancelar o registro desse evento par passando esse identificador para PeerGroupUnregisterEvent. Este parâmetro é necessário.

Retornar valor

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.
E_OUTOFMEMORY	Não há memória suficiente disponível para concluir a operação.
PEER_E_INVALID_GROUP	O identificador para o grupo é inválido.

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

Antes de fechar o identificador HPEEREVENT, você deve cancelar o registro dos tipos de evento par passando o identificador para PeerGroupUnregisterEvent.

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