Função PeerCollabEnumEndpoints (p2p.h)
A função PeerCollabEnumEndpoints retorna o identificador para uma enumeração que contém os pontos de extremidade associados a um contato par específico.
Sintaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumEndpoints(
[in] PCPEER_CONTACT pcContact,
[out] HPEERENUM *phPeerEnum
);
Parâmetros
[in] pcContact
Ponteiro para uma estrutura PEER_CONTACT que contém as informações de contato de um par específico. Esse parâmetro não deve ser NULL.
[out] phPeerEnum
Ponteiro para um identificador para o conjunto enumerado de pontos de extremidade associados ao contato par fornecido. Passe esse identificador para PeerGetNextItem para obter cada item no conjunto enumerado.
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 |
|---|---|
|
Não há memória suficiente para dar suporte a essa operação. |
|
Um dos argumentos é inválido. |
|
A infraestrutura do Windows Peer não é inicializada. É necessário chamar a função de inicialização relevante. |
|
A operação exige que o usuário entre. |
Comentários
É recomendável que um registro de contato seja atualizado usando PeerCollabUpdateContact antes de chamar PeerCollabEnumEndpoints. Não fazer isso pode resultar em um retorno de E_INVALIDARG.
Os pontos de extremidade estarão disponíveis apenas para contatos com fWatch definido como true. Somente os pontos de extremidade que têm o contato "Eu" do par de chamadas salvo como um contato confiável e que tenham WatcherPermissions definidos para permitir estarão disponíveis. Um contato também deve estar conectado à Internet. Caso o contato não esteja conectado, o erro E_INVALIDARG será retornado.
Para obter os pontos de extremidade pares individuais, passe o identificador retornado para PeerGetNextItem. Uma matriz de ponteiros para PEER_ENDPOINT estruturas será retornada. Se nenhum ponto de extremidade estiver disponível, uma matriz vazia será retornada. 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.
O limite para conexões com um único contato é 50.
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 |