Condividi tramite


Funzioni API di raggruppamento

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 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 funzione PeerGroupCreate, PeerGroupJoin o PeerGroupOpen .
PeerGroupConnect Avvia una ricerca PNRP per un gruppo di 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 di peer a cui partecipano altri peer con indirizzi IPv6 noti.
PeerGroupCreate 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 creare un join di un gruppo con 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 le 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 con un invito 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 peer disponibili e delle informazioni sull'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 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 peer. Solo l'autore di un record può eliminarlo.
PeerGroupEnumRecords Crea un'enumerazione dei record del gruppo peer.
PeerGroupGetRecord Recupera un record di gruppo specifico.
PeerGroupSearchRecords Cerca nel database del gruppo peer locale i record che corrispondono ai criteri specificati.
PeerGroupUpdateRecord Aggiornamenti 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 funzione PeerGroupImportDatabase .
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 dell'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 tempo del gruppo peer comune.

 

Funzioni di configurazione del gruppo

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