Partilhar via


Função PeerCollabGetApplicationRegistrationInfo (p2p.h)

A função PeerCollabGetApplicationRegistrationInfo obtém informações de registro específicas do aplicativo.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabGetApplicationRegistrationInfo(
  [in]  const GUID                          *pApplicationId,
  [in]  PEER_APPLICATION_REGISTRATION_TYPE  registrationType,
  [out] PPEER_APPLICATION_REGISTRATION_INFO *ppApplication
);

Parâmetros

[in] pApplicationId

Ponteiro para o valor guid que representa os sinalizadores de registro de aplicativo de um par específico.

[in] registrationType

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

[out] ppApplication

Ponteiro para o endereço de uma estrutura PEER_APPLICATION_REGISTRATION_INFO que contém as informações sobre o aplicativo registrado específico de um par. Os dados retornados nesse parâmetro podem ser liberados chamando PeerFreeData.

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_FOUND
O aplicativo solicitado não está registrado para o registrationType especificado.

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.

O aplicativo de um par tem um GUID que representa um único aplicativo. 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.

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_APPLICATION_REGISTRATION_INFO

PEER_APPLICATION_REGISTRATION_TYPE

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

PeerCollabRegisterApplication

PeerCollabUnregisterApplication