Agrupando funções de API

Artigo
06/13/2023

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 descarta todos os recursos alocados.
PeerGroupStartup	Inicia um grupo de pares usando uma versão solicitada da infraestrutura par.

Funções de criação e acesso de grupo

Função	Descrição
PeerGroupClose	Invalida o identificador de grupo par obtido por uma chamada anterior para a função PeerGroupCreate, PeerGroupJoin ou PeerGroupOpen .
PeerGroupConnect	Inicia uma pesquisa PNRP para um grupo de pares e tenta se conectar a ele. Depois que essa função for chamada com êxito, um par poderá se comunicar com outros membros do grupo par.
PeerGroupConnectByAddress	Tenta se conectar ao grupo de pares do qual outros pares com endereços IPv6 conhecidos estão participando.
PeerGroupCreate	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 unir 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.
PeerGroupJoin	Permite que um par com um convite ingresse em um grupo de pares existente.
PeerGroupOpen	Abre um grupo de pares que um par criou ou ingressou.
PeerGroupParseInvitation	Retorna uma estrutura PEER_INVITATION_INFO com os detalhes de um convite específico.
PeerGroupPasswordJoin	Permite que um par com um convite e a senha correta ingressem em um grupo de pares protegido por senha.

Funções de informações de grupo e membro

Função	Descrição
PeerGroupEnumMembers	Cria uma enumeração de membros do grupo par 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 dessa API, somente o criador do grupo par pode executar essa operação.

Funções de gerenciamento de registros e registros

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 do grupo de pares local em busca de registros que correspondam aos critérios fornecidos.
PeerGroupUpdateRecord	Atualizações 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 par para um arquivo específico, que pode ser transportado para outro computador e importado com a função PeerGroupImportDatabase .
PeerGroupImportDatabase	Importa um banco de dados de grupo par 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 por meio de uma conexão direta ou vizinha.

Infraestrutura de eventos de 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 pares 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 par em um valor de hora localizado apropriado para exibição em um computador par.
PeerGroupUniversalTimeToPeerTime	Converte um valor de hora local do computador de um par em um valor comum de hora do grupo de pares.

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 par para uma identidade com base nas configurações específicas em uma cadeia de caracteres de configuração XML fornecida.