Generieren von Schnittstellen-UUIDs
Dieser Abschnitt enthält Informationen zu UUIDs (Universal Unique Identifiers) und zum Hilfsprogramm Uuidgen in den folgenden Themen:
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 ihn zu identifizieren. Dies ist jedoch in großen Netzwerken in der Regel nicht möglich. Daher weisen Entwickler jeder Schnittstelle in der Regel einen universellen eindeutigen Bezeichner (UUID, austauschbar mit dem Begriff GUID oder Globally Unique Identifier) zu. Eine UUID ist eine Zeichenfolge, die eine Reihe von Hexadezimalziffern enthält. Jede Schnittstelle verfügt über eine andere UUID. Weitere Informationen finden Sie unter String UUID.
Die Textdarstellung einer UUID ist eine Zeichenfolge, die aus acht Hexadezimalziffern, gefolgt von einem Bindestrich, gefolgt von drei durch Bindestriche getrennten Gruppen mit vier Hexadezimalziffern, gefolgt von einem Bindestrich und 12 Hexadezimalziffern 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 nil gibt alles an, was null, leer, 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 (null). Sie wird häufig in 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-Sprachformat.
Wenn Sie das Hilfsprogramm Uuidgen über die Befehlszeile ausführen, können Sie die folgenden Befehlsschalter verwenden.
| Uuidgen-Switch | BESCHREIBUNG |
|---|---|
| /I | 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 < Number (Zahl)> | Gibt die Anzahl der zu generierenden UUIDs an. |
| /v | Zeigt Versionsinformationen zu Uuidgen an. |
| /h oder ? | Zeigt die Zusammenfassung der Befehlsoption 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 obige Befehl ausgeführt wird, ähnelt der Inhalt von MyApp.idl folgendem:
[
uuid(ba209999-0c6c-11d2-97cf-00c04f8eea45),
version(1.0)
]
interface INTERFACENAME
{
}
Der nächste Schritt besteht darin, den Platzhalternamen INTERFACENAME durch den tatsächlichen Namen Ihrer Schnittstelle zu ersetzen.