Compartilhar via


Função PeerCollabEnumPeopleNearMe (p2p.h)

A função PeerCollabEnumPeopleNearMe retorna um identificador para um conjunto enumerado que contém todos os pontos de extremidade de "pessoas próximas a mim" da rede de colaboração par atualmente disponíveis na sub-rede do par de chamada.

Sintaxe

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

Parâmetros

[out] phPeerEnum

Ponteiro para um identificador de um conjunto enumerado que contém todos os pontos de extremidade de "pessoas próximas a mim" da rede de colaboração par atualmente disponíveis na sub-rede do par de chamada.

Retornar valor

Retorna S_OK se a função for bem-sucedida. Caso contrário, a função retornará um dos valores a seguir.

Código de retorno Descrição
E_OUTOFMEMORY
Não há memória suficiente para dar suporte a essa operação.
E_INVALIDARG
Um dos argumentos é inválido.
PEER_E_NOT_INITIALIZED
A infraestrutura do Windows Peer não é inicializada. É necessário chamar a função de inicialização relevante.
PEER_E_NOT_SIGNED_IN
A operação exige que o usuário entre.

Comentários

Para obter os contatos individuais de "pessoas próximas a mim", passe o identificador retornado para PeerGetNextItem. Uma matriz de ponteiros para as estruturas de PEER_PEOPLE_NEAR_ME são retornados. Para fechar a enumeração e liberar os recursos associados a ela, passe esse identificador para PeerEndEnumeration. Itens individuais retornados pela enumeração devem ser liberados com PeerFreeData.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
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_PEOPLE_NEAR_ME

Funções da API de Colaboração de Pares

PeerCollabSignin