Compartilhar via


Função PeerEnumIdentities (p2p.h)

A função PeerEnumIdentities cria e retorna um identificador de enumeração par usado para enumerar todas as identidades de pares que pertencem a um usuário específico.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerEnumIdentities(
  [out] HPEERENUM *phPeerEnum
);

Parâmetros

[out] phPeerEnum

Recebe um identificador para a enumeração par que contém a lista de identidades de pares, 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
E_INVALIDARG
Um dos parâmetros não é válido.
E_OUTOFMEMORY
Não há memória suficiente para executar a operação especificada.

Comentários

Depois que o aplicativo tiver obtido o identificador de enumeração par, use PeerGetNextItem e PeerGetItemCount para enumerar as identidades de pares.

Ao enumerar identidades de pares, PeerGetNextItem retorna uma matriz de ponteiros para PEER_NAME_PAIR estruturas.

Chame PeerEndEnumeration para liberar o identificador de enumeração 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

Confira também

PEER_NAME_PAIR

PeerEndEnumeration

PeerGetItemCount

PeerGetNextItem