Função PeerCollabEnumApplicationRegistrationInfo (p2p.h)
A função PeerCollabEnumApplicationRegistrationInfo obtém o identificador de enumeração usado para recuperar informações de aplicativo par.
Sintaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumApplicationRegistrationInfo(
[in] PEER_APPLICATION_REGISTRATION_TYPE registrationType,
[out] HPEERENUM *phPeerEnum
);
Parâmetros
[in] registrationType
Um valor PEER_APPLICATION_REGISTRATION_TYPE que especifica se o aplicativo do par está registrado para o usuário atual ou todos os usuários do computador do par.
[out] phPeerEnum
Ponteiro para um identificador de enumeração par para as informações de registro de aplicativo par. Esses dados são obtidos passando esse identificador para PeerGetNextItem.
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. |
Comentários
Para obter os aplicativos pares individuais, passe o identificador retornado para PeerGetNextItem. Uma matriz de estruturas de PEER_APPLICATION_REGISTRATION_INFO 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 lançados com PeerFreeData.
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 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.
Os itens de informações de registro de aplicativo par são retornados como estruturas de PEER_APPLICATION_REGISTRATION_INFO individuais.
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