Função PeerCollabSignin (p2p.h)

A função PeerCollabSignin assina o par em um provedor de presença de rede de colaboração par da Internet hospedada (presença sem servidor) ou sub-rede ("Pessoas Near Me").

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSignin(
  [in] HWND  hwndParent,
  [in] DWORD dwSigninOptions
);

Parâmetros

[in] hwndParent

O Windows lida com o aplicativo pai entrando.

[in] dwSigninOptions

PEER_SIGNIN_FLAGS valor de enumeração que contém as opções de entrada do provedor de presença para o par de chamada.

Valor retornado

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	O aplicativo não fez uma chamada anterior para PeerCollabStartup.
PEER_E_SERVICE_NOT_AVAILABLE	Foi feita uma tentativa de chamar PeerCollabSignIn de um processo elevado.
PEER_S_NO_CONNECTIVITY	A entrada foi bem-sucedida, mas os endereços IPv6 não estão disponíveis no momento.

Comentários

Se o serviço p2phost.exe não estiver em execução, essa função o iniciará.

Se for feita uma tentativa de iniciar o serviço p2phost.exe de um processo elevado, um erro será retornado. Como resultado, a segurança não pode ser comprometida por um aplicativo concedendo por engano privilégios administrativos a p2phost.exe. Não é possível iniciar p2phost.exe em um modo não interativo, pois ele precisa exibir caixas de diálogo do Windows para convites de entrada.

Chamar PeerCollabSignin exibirá uma interface do usuário de entrada se o usuário não tiver autorizado a entrada automática. Se hwndParent for especificado, a janela de interface do usuário usará hwndParent como a janela pai.

Quando um usuário entra em "Pessoas Near Me", o nome de exibição do usuário, o nome do computador e o endereço IP são publicados em pares na sub-rede. Opcionalmente, o usuário pode especificar uma imagem de exibição para publicação. Essas informações não serão publicadas se PeerCollabSignin não for chamado ou o usuário sair.

Depois de conectado, o usuário pode exibir uma lista de pares conectados na sub-rede e disponíveis para interação. Essa lista estará vazia se ninguém mais tiver se conectado ao "Pessoas Near Me" na sub-rede.

Vários aplicativos podem usar a infraestrutura a qualquer momento. Não é recomendável que um único aplicativo chame PeerCollabSignout, pois outros aplicativos não poderão usar a infraestrutura. Os aplicativos também devem estar preparados para lidar com a entrada e saída do usuário ou situações em que um computador entra em suspensão ou hibernação.

A função PeerCollabSignin atualmente requer até dois segundos para ser concluída.

Os nomes de exibição não são necessariamente exclusivos. Os usuários devem verificar a identidade da pessoa que usa um nome de exibição por email, telefone ou pessoalmente antes de aceitar um convite para interagir.

Para sair de uma rede colaborativa par, chame PeerCollabSignout com o mesmo conjunto de opções de entrada. Um usuário também pode sair por meio da interface do usuário.

Requisitos


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