Compartilhar via


Função PeerGroupEnumConnections (p2p.h)

A função PeerGroupEnumConnections cria uma enumeração de conexões atualmente ativas no par.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupEnumConnections(
  [in]  HGROUP    hGroup,
  [in]  DWORD     dwFlags,
  [out] HPEERENUM *phPeerEnum
);

Parâmetros

[in] hGroup

Identificador para o grupo que contém as conexões a serem enumeradas. Esse identificador é retornado pela função PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Este parâmetro é necessário.

[in] dwFlags

Especifica os sinalizadores que indicam o tipo de conexão a ser enumerada. Os valores válidos são especificados por PEER_CONNECTION_FLAGS.

[out] phPeerEnum

Ponteiro para a enumeração que contém a lista retornada de conexões ativas. Esse identificador é passado para
PeerGetNextItem para recuperar os itens, com cada item representado como um ponteiro para uma estrutura PEER_CONNECTION_INFO . Quando concluído, PeerEndEnumeration é chamado para retornar a memória usada pela enumeração . 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.
E_OUTOFMEMORY
Não há memória suficiente para executar a operação especificada.
PEER_E_INVALID_GROUP
O identificador para o grupo de pares é 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.

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

PeerEndEnumeration

PeerGetItemCount

PeerGetNextItem