Freigeben über


Generieren von Schnittstellen-UUIDs

In diesem Abschnitt werden Informationen zu Universellen eindeutigen Bezeichnern (UUIDs) und dem Hilfsprogramm Uuidgen in den folgenden Themen vorgestellt:

Was ist eine UUID?

Alle Schnittstellen müssen in einem Netzwerk eindeutig identifiziert werden, damit Clients sie finden können. In kleinen Netzwerken kann der Name der Schnittstelle allein ausreichen, um sie zu identifizieren. In großen Netzwerken ist dies jedoch in der Regel nicht machbar. Daher weisen Entwickler in der Regel jeder Schnittstelle einen universellen eindeutigen Bezeichner (UUID, austauschbar mit dem Begriff GUID oder Globally Unique Identifier) zu. Eine UUID ist eine Zeichenfolge, die einen Satz hexadezimaler Ziffern enthält. Jede Schnittstelle verfügt über eine andere UUID. Ausführliche Informationen finden Sie unter UUID für Zeichenfolgen.

Die Textdarstellung einer UUID ist eine Zeichenfolge, die aus 8 Hexadezimalstellen gefolgt von einem Bindestrich, gefolgt von drei durch Bindestrich getrennten Gruppen von 4 Hexadezimalstellen, gefolgt von einem Bindestrich, gefolgt von 12 Hexadezimalstellen besteht. Das folgende Beispiel ist eine gültige UUID-Zeichenfolge:

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

Leere UUIDs werden als null-UUIDs und nicht als NULL-UUIDs bezeichnet. Der Begriff "null" gibt alles an, was null, leer oder nicht initialisiert ist. Eine leere Zeichenfolge, ein leerer Datenbankdatensatz oder eine nicht initialisierte UUID sind Beispiele für Nullwerte.

Hinweis

Der Wert NULL ist der spezifische Wert 0. Es wird häufig in der C- und C++-Programmierung in Verbindung mit Zeigern verwendet. Nil ist ein allgemeinerer Begriff als NULL. Nicht initialisierte Objektschnittstellen-UUIDs sollten immer als Null-UUIDs und nicht als NULL-UUIDs bezeichnet werden.

 

Verwenden von Uuidgen

Microsoft stellt ein Hilfsprogramm namens Uuidgen bereit, um Ihre UUIDs zu generieren. Das Hilfsprogramm Uuidgen generiert die UUID im IDL-Dateiformat oder im C-Format.

Wenn Sie das Hilfsprogramm Uuidgen über die Befehlszeile ausführen, können Sie die folgenden Befehlsoptionen verwenden.

Uuidgen-Switch BESCHREIBUNG
/Ich Gibt UUID an eine IDL-Schnittstellenvorlage aus.
/s Gibt UUID als initialisierte C-Struktur aus.
/O<Dateiname> Leitet die Ausgabe an eine Datei um. wird unmittelbar nach dem Schalter /o angegeben.
/N<Anzahl> Gibt die Anzahl der zu generierenden UUIDs an.
/v Zeigt Versionsinformationen zu Uuidgen an.
/h oder ? Zeigt die Befehlsoptionszusammenfassung an.

 

In der Regel verwenden Sie das Hilfsprogramm Uuidgen, wie im folgenden Beispiel gezeigt.

uuidgen -i -oMyApp.idl

Dieser Befehl generiert eine UUID und speichert sie in einer MIDL-Datei, die Sie als Vorlage verwenden können. Wenn der vorherige Befehl ausgeführt wird, ähnelt der Inhalt von MyApp.idl dem folgenden:

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

}

Der nächste Schritt besteht im Ersetzen des Platzhalternamens INTERFACENAME durch den tatsächlichen Namen Ihrer Schnittstelle.