Função PeerCollabRegisterApplication (p2p.h)

A função PeerCollabRegisterApplication registra um aplicativo com o computador local para que ele possa ser iniciado em uma atividade de colaboração par.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRegisterApplication(
  [in] PCPEER_APPLICATION_REGISTRATION_INFO pcApplication,
  [in] PEER_APPLICATION_REGISTRATION_TYPE   registrationType
);

Parâmetros

[in] pcApplication

Ponteiro para uma estrutura PEER_APPLICATION_REGISTRATION_INFO que contém a UUID do conjunto de recursos de aplicativo do par, bem como quaisquer dados adicionais específicos do par.

[in] registrationType

Um valor PEER_APPLICATION_REGISTRATION_TYPE que descreve se o aplicativo do par está registrado para o usuário atual ou todos os usuários do computador do par.

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.

Comentários

Um aplicativo é um conjunto de recursos de software ou software disponíveis no ponto de extremidade do par. Normalmente, isso se refere a pacotes de software que dão suporte a atividades de rede de pares, como jogos ou outros aplicativos colaborativos.

A infraestrutura de colaboração pode receber convites de aplicativos de contatos confiáveis ou de "Pessoas Near Me", que se baseiam no escopo com o qual a infraestrutura de colaboração está conectado usando PeerCollabSignin.

O aplicativo de um par tem um GUID que representa um único aplicativo específico. Quando um aplicativo é registrado para um par, esse GUID e o aplicativo correspondente podem ser disponibilizados para todos os contatos confiáveis do par, indicando as atividades das quais o par pode participar. Para cancelar o registro do aplicativo de um par, chame PeerCollabUnregisterApplication com esse GUID.

Ao registrar um aplicativo, é recomendável que os desenvolvedores especifiquem um caminho relativo, como %ProgramFiles%, em vez de um caminho absoluto. Isso impede a falha do aplicativo devido a uma alteração no local dos arquivos de aplicativo. Por exemplo, se o diretório C:\ProgramFiles for movido para E:\.

Somente aplicativos locais para o computador podem ser registrados. Não é possível registrar quando o caminho executável de um aplicativo está localizado em um compartilhamento de rede, como um caminho UNC ou uma unidade de rede mapeada localmente.

Os aplicativos podem ser registrados nos escopos 'ALL_USERS' e 'CURRENT_USER'. Caso um aplicativo seja registrado em ambos os escopos simultaneamente, um aplicativo registrado no escopo 'CURRENT_USER' terá precedência sobre um aplicativo registrado no escopo 'ALL_USERS'. É importante observar que para registrar-se para o tipo de registro de 'ALL_USERS' o chamador deve estar operando com privilégios administrativos.

O número máximo de aplicativos que podem ser registrados para um registrationType específico é 64.

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