Share via


Generazione di UUID dell'interfaccia

Questa sezione presenta informazioni sugli identificatori univoci universali (UUID) e l'utilità Uuidgen negli argomenti seguenti:

Che cos'è un UUID?

Tutte le interfacce devono essere identificate in modo univoco in una rete in modo che i client possano trovarli. In reti di piccole dimensioni, il nome dell'interfaccia può essere sufficiente per identificarlo. Tuttavia, in genere non è possibile su reti di grandi dimensioni. Pertanto, gli sviluppatori assegnano in genere un identificatore univoco universale (UUID, intercambiabile con il termine GUID o Identificatore univoco globale) a ogni interfaccia. Un UUID è una stringa che contiene un set di cifre esadecimali. Ogni interfaccia ha un UUID diverso. Per informazioni dettagliate, vedere String UUID.

La rappresentazione testuale di un UUID è una stringa costituita da 8 cifre esadecimali seguite da un trattino, seguito da tre gruppi di trattini separati da 4 cifre esadecimali, seguito da un trattino, seguito da 12 cifre esadecimali. L'esempio seguente è una stringa UUID valida:

ba2099999-0c6c-11d2-97cf-00c04f8eea45

Gli UUID vuoti sono detti UUID null anziché UUID NULL . Il termine nil indica qualsiasi elemento zero, vuoto, vuoto o non inizializzato. Una stringa vuota, un record di database vuoto o un UUID non inizializzato sono tutti esempi di valori null.

Nota

Il valore NULL è il valore specifico zero. Viene spesso usato nella programmazione C e C++ insieme ai puntatori. Nil è un termine più generale di NULL. Gli UUID dell'interfaccia dell'oggetto non inizializzati devono essere sempre definiti UUID null anziché UUID NULL .

 

Uso di Uuidgen

Microsoft fornisce un programma di utilità denominato Uuidgen per generare gli UUID. L'utilità Uuidgen genera l'UUID in formato file IDL o in formato linguaggio C.

Quando si esegue l'utilità Uuidgen dalla riga di comando, è possibile usare le opzioni di comando seguenti.

Opzione Uuidgen Descrizione
/Ho Restituisce UUID in un modello di interfaccia IDL.
/s Restituisce UUID come struttura C inizializzata.
/o<Filename> Reindirizza l'output a un file; specificato immediatamente dopo l'opzione /o .
/N<Numero> Specifica il numero di UUID da generare.
/v Visualizza le informazioni sulla versione su Uuidgen.
/h o ? Visualizza il riepilogo delle opzioni di comando.

 

In genere, si userà l'utilità Uuidgen, come illustrato nell'esempio seguente.

uuidgen -i -oMyApp.idl

Questo comando genera un UUID e lo archivia in un file MIDL che è possibile usare come modello. Quando viene eseguito il comando precedente, il contenuto di MyApp.idl è simile al seguente:

[
  uuid(ba209999-0c6c-11d2-97cf-00c04f8eea45),
  version(1.0)
]
interface INTERFACENAME
{

}

Il passaggio successivo consiste nel sostituire il nome segnaposto, INTERFACENAME, con il nome effettivo dell'interfaccia.