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