Agrupando funções da API

Artigo
03/13/2025

A API de agrupamento usa as seguintes funções:

Funções de inicialização e limpeza de grupo

Função	Descrição
PeerGroupShutdown	Fecha um grupo de pares criado com PeerGroupStartup e elimina todos os recursos alocados.
PeerGroupStartup	Inicia um grupo de pares usando uma versão solicitada da infraestrutura de mesmo nível.

Criação de Grupo e Funções de Acesso

Função	Descrição
PeerGroupClose	Invalida o identificador de grupo de pares obtido por uma chamada anterior para o PeerGroupCreate , PeerGroupJoinou função de PeerGroupOpen.
PeerGroupConnect	Inicia uma pesquisa PNRP para um grupo de pares e tenta se conectar a ele. Depois que essa função é chamada com êxito, um par pode se comunicar com outros membros do grupo de pares.
PeerGroupConnectByAddress	Tenta se conectar ao grupo de pares do qual outros pares com endereços IPv6 conhecidos estão participando.
PeerGroupCriar	Cria um novo grupo de pares.
PeerGroupCreateInvitation	Retorna uma cadeia de caracteres XML que pode ser usada pelo par especificado para ingressar em um grupo.
PeerGroupCreatePasswordInvitation	Retorna uma cadeia de caracteres XML que pode ser usada pelo par especificado para ingressar em um grupo com uma senha correspondente.
PeerGroupDelete	Exclui os dados locais e o certificado associados a um grupo de pares.
PeerGroupGetStatus	Recupera o status atual de um grupo.
PeerGroupIssueCredentials	Emite credenciais, incluindo um GMC, para uma identidade específica e, opcionalmente, retorna uma cadeia de caracteres XML de convite que o par convidado pode usar para ingressar em um grupo de pares.
PeerGroupJunte-se	Permite que um par com um convite participe de um grupo de pares existente.
PeerGroupAbrir	Abre um grupo de pares que um par criou ou participou.
PeerGroupParseInvitation	Retorna uma estrutura de PEER_INVITATION_INFO com os detalhes de um convite específico.
PeerGroupPasswordJoin	Permite que um par com um convite e a senha correta ingresse em um grupo de pares protegido por senha.

Funções de Informação de Grupos e Membros

Função	Descrição
PeerGroupEnumMembros	Cria uma enumeração de membros do grupo de pares disponíveis e as informações de associação associadas.
PeerGroupGetProperties	Recupera informações sobre as propriedades de um grupo especificado.
PeerGroupSetProperties	Define as propriedades atuais do grupo de pares. Na versão 1.0 desta API, apenas o criador do grupo de pares pode executar esta operação.

Funções de Gestão de Registos e Registos

Função	Descrição
PeerGroupAddRecord	Adiciona um novo registro ao grupo de pares, que é propagado para todos os pares participantes.
PeerGroupDeleteRecord	Exclui um registro de um grupo de pares. Somente o criador de um registro pode excluí-lo.
PeerGroupEnumRecords	Cria uma enumeração de registros de grupo de pares.
PeerGroupGetRecord	Recupera um registro de grupo específico.
PeerGroupSearchRecords	Pesquisa o banco de dados de grupo de pares local em busca de registros que correspondam aos critérios fornecidos.
PeerGroupUpdateRecord	Atualiza um registro dentro de um grupo de pares específico.

Funções de importação/exportação de banco de dados de grupo

Função	Descrição
PeerGroupExportDatabase	Exporta um banco de dados de grupo de pares para um arquivo específico, que pode ser transportado para outro computador e importado com a funçãoPeerGroupImportDatabase.
PeerGroupImportDatabase	Importa um banco de dados de grupo de pares de um arquivo local.

Funções de conexão direta

Função	Descrição
PeerGroupCloseDirectConnection	Fecha uma conexão direta específica entre dois pares.
PeerGroupEnumConnections	Cria uma enumeração de conexões atualmente ativas no par.
PeerGroupOpenDirectConnection	Estabelece uma conexão direta com outro par em um grupo de pares.
PeerGroupSendData	Envia dados para um membro através de um vizinho ou conexão direta.

Infraestrutura de Eventos em Grupo

Função	Descrição
PeerGroupGetEventData	Permite que um aplicativo recupere os dados retornados por um evento de agrupamento.
PeerGroupRegisterEvent	Registra um par para eventos de grupo de pares específicos.
PeerGroupUnregisterEvent	Cancela o registro de um par da notificação de eventos de mesmo nível associados ao identificador de evento fornecido.

Funções de conversão de tempo de grupo

Função	Descrição
PeerGroupPeerTimeToUniversalTime	Converte o valor de tempo de referência mantido pelo grupo de pares em um valor de tempo localizado apropriado para exibição em um computador par.
PeerGroupUniversalTimeToPeerTime	Converte um valor de hora local do computador de um par em um valor de tempo de grupo de pares comum.

Funções de configuração de grupo

Função	Descrição
PeerGroupExportConfig	Exporta a configuração de grupo para um par como uma cadeia de caracteres XML que contém a identidade, o nome do grupo e o GMC para a identidade.
PeerGroupImportConfig	Importa uma configuração de grupo de pares para uma identidade com base nas configurações específicas em uma cadeia de caracteres de configuração XML fornecida.