Função PeerGroupEnumMembers (p2p.h)
A função PeerGroupEnumMembers cria uma enumeração de membros de grupo par disponíveis e as informações de associação associadas.
Sintaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupEnumMembers(
[in] HGROUP hGroup,
[in] DWORD dwFlags,
[in] PCWSTR pwzIdentity,
[out] HPEERENUM *phPeerEnum
);
Parâmetros
[in] hGroup
Manipule para o grupo de pares cujos membros são enumerados. Esse identificador é retornado pela função PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Este parâmetro é necessário.
[in] dwFlags
Especifica os sinalizadores de PEER_MEMBER_FLAGS que indicam quais tipos de membros incluir na enumeração. Se esse valor for definido como zero, todos os membros do grupo de pares serão incluídos.
| Valor | Significado |
|---|---|
|
Enumerar todos os membros do grupo de pares atual que estão online. |
[in] pwzIdentity
Cadeia de caracteres Unicode que contém a identidade de um par específico cujas informações são recuperadas e retornadas em uma enumeração de um item. Se esse parâmetro for NULL, todos os membros do grupo de pares atual serão recuperados. Este parâmetro é necessário.
[out] phPeerEnum
Ponteiro para a enumeração que contém a lista retornada de membros do grupo par. Esse identificador é passado para
PeerGetNextItem para recuperar os itens, com cada item representado como um ponteiro para uma estrutura PEER_MEMBER . Quando concluído, PeerEndEnumeration é chamado para retornar a memória usada pela enumeração . 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 |
|---|---|
|
Um dos parâmetros não é válido. |
|
Não há memória suficiente para executar a operação especificada. |
|
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.
Comentários
O nó local é sempre o primeiro item na enumeração se pwzIdentity for NULL e dwFlags for definido para indicar que o nó local é um membro do subconjunto explícito.
Por padrão, cada membro publica informações de associação no grupo de pares. Se PEER_MEMBER_DATA_OPTIONAL estiver definido no PEER_MEMBER dados desse par, essas informações só ficam disponíveis quando um par executa uma ação dentro do grupo, por exemplo, publicando um registro, atualizando a presença ou emitindo um GMC.
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 |