Generazione di UUID dell'interfaccia

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

• Che cos'è un UUID?
• L'uso di Uuidgen

Che cos'è un UUID?

Tutte le interfacce devono essere identificate in modo univoco in una rete in modo che i client possano trovarli. Nelle reti di piccole dimensioni, il nome dell'interfaccia può essere sufficiente per identificarlo. Tuttavia, questo in genere non è fattibile 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 UUID della stringa.

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

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

Gli UUID vuoti vengono definiti UUID nil anziché UUID NULL. Il termine nil indica qualcosa che è zero, 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++ in combinazione con i puntatori. Nil è un termine più generale di NULL. Gli UUID dell'interfaccia oggetto non inizializzata devono sempre essere definiti UUID nil 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 di file IDL o in formato linguaggio C.

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

Interruttore Uuidgen	Descrizione
/i	Restituisce l'UUID in un modello di interfaccia IDL.
/s	Restituisce l'UUID come struttura C inizializzata.
/o<nome file>	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 di Uuidgen.
/h o ?	Visualizza il riepilogo delle opzioni di comando.

 

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

-i uuidgen -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.