Génération d’UUIDs d’interface

  • Article

Cette section présente des informations sur les identificateurs uniques universels (UUID) et l’utilitaire Uuidgen dans les rubriques suivantes :

Qu’est-ce qu’un UUID ?

Toutes les interfaces doivent être identifiées de manière unique sur un réseau afin que les clients puissent les trouver. Sur les petits réseaux, le nom de l’interface peut suffire à lui seul pour l’identifier. Toutefois, cela n’est généralement pas possible sur les grands réseaux. Par conséquent, les développeurs attribuent généralement un identificateur unique universel (UUID, interchangeable avec le terme GUID ou Identificateur global unique) à chaque interface. Un UUID est une chaîne qui contient un ensemble de chiffres hexadécimaux. Chaque interface a un UUID différent. Pour plus d’informations, consultez String UUID.

La représentation textuelle d’un UUID est une chaîne composée de 8 chiffres hexadécimaux suivis d’un trait d’union, suivis de trois groupes séparés par des traits d’union de 4 chiffres hexadécimaux, suivis d’un trait d’union, suivis de 12 chiffres hexadécimaux. L’exemple suivant est une chaîne UUID valide :

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

Les UUID vides sont appelés UUIDs nil plutôt que NULL UUIDs. Le terme nil indique tout ce qui est zéro, vide, vide ou non initialisé. Une chaîne vide, un enregistrement de base de données vide ou un UUID non initialisé sont tous des exemples de valeurs nulles.

Notes

La valeur NULL est la valeur spécifique zéro. Il est souvent utilisé dans la programmation C et C++ conjointement avec des pointeurs. Nil est un terme plus général que NULL. Les UIID d’interface objet non initialisées doivent toujours être appelés UUIDs nil plutôt que NULL .

 

Utilisation d’Uuidgen

Microsoft fournit un programme utilitaire appelé Uuidgen pour générer vos UUID. L’utilitaire Uuidgen génère l’UUID au format de fichier IDL ou au format C.

Lorsque vous exécutez l’utilitaire Uuidgen à partir de la ligne de commande, vous pouvez utiliser les commutateurs de commande suivants.

Commutateur Uuidgen Description
/Je Génère l’UUID vers un modèle d’interface IDL.
/s Génère l’UUID en tant que structure C initialisée.
/O<Fichier> Redirige la sortie vers un fichier ; spécifié immédiatement après le commutateur /o .
/¡n<Nombre> Spécifie le nombre d’UUID à générer.
/v Affiche des informations de version sur Uuidgen.
/h ou ? Affiche le résumé des options de commande.

 

En règle générale, vous allez utiliser l’utilitaire Uuidgen comme indiqué dans l’exemple suivant.

uuidgen -i -oMyApp.idl

Cette commande génère un UUID et le stocke dans un fichier MIDL que vous pouvez utiliser comme modèle. Lorsque la commande précédente est exécutée, le contenu de MyApp.idl est similaire à ce qui suit :

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

}

L’étape suivante consiste à remplacer le nom de l’espace réservé, INTERFACENAME, par le nom réel de votre interface.