Função PeerEnumGroups (p2p.h)
A função PeerEnumGroups cria e retorna um identificador de enumeração par usado para enumerar todos os grupos de pares associados a uma identidade de par específica.
Sintaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerEnumGroups(
[in] PCWSTR pwzIdentity,
[out] HPEERENUM *phPeerEnum
);
Parâmetros
[in] pwzIdentity
Especifica a identidade de par para a qual enumerar grupos.
[out] phPeerEnum
Recebe um identificador para a enumeração par que contém a lista de grupos de pares dos quais a identidade especificada é membro, com cada item representado como um ponteiro para uma estrutura PEER_NAME_PAIR . Passe esse identificador para PeerGetNextItem para recuperar os itens; quando terminar, chame PeerEndEnumeration para liberar a memória.
Retornar valor
Se a chamada de função for bem-sucedida, o valor retornado será S_OK. Caso contrário, ele 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. |
|
A identidade de par especificada não pode ser encontrada. |
Comentários
Depois que o aplicativo tiver obtido o identificador de enumeração, use PeerGetNextItem e PeerGetItemCount para enumerar os grupos de pares.
Ao enumerar grupos de pares, PeerGetNextItem retorna uma matriz de ponteiros para PEER_NAME_PAIR estruturas.
Chame PeerEndEnumeration para liberar o identificador de enumeração par quando ele não for mais necessário.
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 para Windows XP |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | p2p.h |
| Biblioteca | P2P.lib |
| DLL | P2P.dll |