Funzioni API di raggruppamento

Articolo
03/13/2025

L'API di raggruppamento usa le funzioni seguenti:

Funzioni di inizializzazione e pulizia dei gruppi

Funzione	Descrizione
PeerGroupShutdown	Chiude un gruppo di peer creato con PeerGroupStartup ed elimina le risorse allocate.
PeerGroupStartup	Avvia un gruppo di peer usando una versione richiesta dell'infrastruttura peer.

Funzioni di creazione e accesso di gruppo

Funzione	Descrizione
PeerGroupClose	Invalida l'handle del gruppo peer ottenuto da una chiamata precedente alla PeerGroupCreate, PeerGroupJoino funzione PeerGroupOpen.
PeerGroupConnect	Avvia una ricerca PNRP per un gruppo peer e tenta di connettersi. Dopo aver chiamato correttamente questa funzione, un peer può comunicare con altri membri del gruppo peer.
PeerGroupConnectByAddress	Tenta di connettersi al gruppo peer a cui partecipano altri peer con indirizzi IPv6 noti.
PeerGroupCreare	Crea un nuovo gruppo di peer.
PeerGroupCreateInvitation	Restituisce una stringa XML che può essere utilizzata dal peer specificato per aggiungere un gruppo.
PeerGroupCreatePasswordInvitation	Restituisce una stringa XML che può essere utilizzata dal peer specificato per aggiungere un gruppo a una password corrispondente.
PeerGroupDelete	Elimina i dati locali e il certificato associati a un gruppo di peer.
PeerGroupGetStatus	Recupera lo stato corrente di un gruppo.
PeerGroupIssueCredentials	Rilascia credenziali, incluso un GMC, a un'identità specifica e, facoltativamente, restituisce una stringa XML di invito che il peer invitato può usare per partecipare a un gruppo di peer.
PeerGroupJoin	Consente a un peer di partecipare a un gruppo di peer esistente.
PeerGroupOpen	Apre un gruppo di peer creato o unito a un peer.
PeerGroupParseInvitation	Restituisce una struttura PEER_INVITATION_INFO con i dettagli di un invito specifico.
PeerGroupPasswordJoin	Consente a un peer con un invito e alla password corretta di aggiungere un gruppo di peer protetto da password.

Funzioni di informazioni sui gruppi e sui membri

Funzione	Descrizione
PeerGroupEnumMembers	Crea un'enumerazione dei membri del gruppo di peer disponibili e delle informazioni di appartenenza associate.
PeerGroupGetProperties	Recupera informazioni sulle proprietà di un gruppo specificato.
PeerGroupSetProperties	Imposta le proprietà correnti del gruppo di peer. Nella versione 1.0 di questa API solo l'autore del gruppo di peer può eseguire questa operazione.

Funzioni di gestione record e record

Funzione	Descrizione
PeerGroupAddRecord	Aggiunge un nuovo record al gruppo peer, che viene propagato a tutti i peer partecipanti.
PeerGroupDeleteRecord	Elimina un record da un gruppo di peer. Solo l'autore di un record può eliminarlo.
peergroupEnumRecords	Crea un'enumerazione di record del gruppo peer.
PeerGroupGetRecord	Recupera un record di gruppo specifico.
PeerGroupSearchRecords	Cerca nel database del gruppo di peer locale i record che corrispondono ai criteri specificati.
PeerGroupUpdateRecord	Aggiorna un record all'interno di un gruppo di peer specifico.

Funzioni di importazione/esportazione del database di gruppo

Funzione	Descrizione
PeerGroupExportDatabase	Esporta un database del gruppo di peer in un file specifico, che può essere trasportato in un altro computer e importato con la funzionePeerGroupImportDatabase.
peergroupImportDatabase	Importa un database del gruppo di peer da un file locale.

Funzioni di connessione diretta

Funzione	Descrizione
peergroupCloseDirectConnection	Chiude una connessione diretta specifica tra due peer.
PeerGroupEnumConnections	Crea un'enumerazione delle connessioni attualmente attive nel peer.
peergroupOpenDirectConnection	Stabilisce una connessione diretta con un altro peer in un gruppo di peer.
PeerGroupSendData	Invia dati a un membro tramite una connessione vicina o diretta.

Infrastruttura di eventi di gruppo

Funzione	Descrizione
peergroupGetEventData	Consente a un'applicazione di recuperare i dati restituiti da un evento di raggruppamento.
peergroupRegisterEvent	Registra un peer per eventi specifici del gruppo di peer.
PeerGroupUnregisterEvent	Annulla la registrazione di un peer dalla notifica degli eventi peer associati all'handle dell'evento fornito.

Funzioni di conversione ora di gruppo

Funzione	Descrizione
PeerGroupPeerTimeToUniversalTime	Converte il valore del tempo di riferimento gestito dal gruppo peer in un valore di ora localizzato appropriato per la visualizzazione in un computer peer.
PeerGroupUniversalTimeToPeerTime	Converte un valore di ora locale dal computer di un peer a un valore di ora del gruppo peer comune.

Funzioni di configurazione del gruppo

Funzione	Descrizione
PeerGroupExportConfig	Esporta la configurazione del gruppo per un peer come stringa XML che contiene l'identità, il nome del gruppo e il GMC per l'identità.
PeerGroupImportConfig	Importa una configurazione di un gruppo di peer per un'identità in base alle impostazioni specifiche in una stringa di configurazione XML fornita.