uuid-Attribut

Das [ ] uuid-Schnittstellenattribut bezeichnet einen UUID (Universally Unique Identifier), der der Schnittstelle zugewiesen ist und ihn von anderen Schnittstellen unterscheidet.

uuid (string-uuid) 
uuid ("string-uuid")

Parameter

string-uuid

Gibt eine Zeichenfolge an, die aus acht Hexadezimalziffern gefolgt von einem Bindestrich, dann drei Gruppen von vier Hexadezimalziffern gefolgt von einem Bindestrich und dann 12 Hexadezimalziffern besteht. Sie können die UUID-Zeichenfolge in Anführungszeichen setzen, außer wenn Sie den MIDL-Compilerschalter /osf verwenden.

Bemerkungen

Die Laufzeitbibliothek verwendet die Schnittstellen-UUID, die das [ ] uuid-Attribut bestimmt, um die Kommunikation zwischen Client- und Serveranwendungen herzustellen. Das [ uuid-Attribut ] kann in der Schnittstellenattributliste für eine RPC-Schnittstelle oder eine COM-Schnittstelle angezeigt werden.

Für eine RPC-Schnittstelle muss die Schnittstellenattributliste entweder das [ ] uuid-Attribut oder das lokale Attribut enthalten, und das von Ihnen bestimmte Attribut muss genau [ ] einmal auftreten. Wenn die Liste das [ uuid-Attribut ] enthält, kann sie auch das [ Versionsattribut ] enthalten.

Für eine COM-Schnittstelle (identifiziert durch das Objektschnittstellenattribut) muss die Schnittstellenattributliste das [ ] [ ] uuid-Attribut enthalten, darf jedoch nicht das [ ] Versionsattribut enthalten. Die Liste für eine COM-Schnittstelle kann das [ lokale Attribut enthalten, ] obwohl das [ uuid-Attribut ] vorhanden ist.

Microsoft RPC unterstützt eine Erweiterung der DCE-IDL, mit der die UUID in doppelte Anführungszeichen ("" "") eingeschlossen werden kann. Das Formular in Anführungszahlen ist für C-Compiler-Präprozessoren erforderlich, die UUID-Zahlen als Gleitkommazahlen interpretieren.

Alle UUID-Werte sollten computergeneriert werden, um Eindeutigkeit zu gewährleisten. Verwenden Sie das Uuidgen-Hilfsprogramm, um eindeutige UUID-Werte zu generieren.

Die UUID und Die Versionsnummern der Schnittstelle werden verwendet, um zu bestimmen, ob der Client eine Bindung an den Server herstellen kann. Damit der Client an den Server gebunden werden kann, muss die in den Client- und Serverschnittstellen angegebene UUID identisch sein.

Beachten Sie, dass eine Schnittstelle ohne Attribute in eine IDL-Basisdatei importiert werden kann. Die Schnittstelle darf jedoch nur Datentypen ohne Prozeduren enthalten. Wenn auch nur eine Prozedur in der Schnittstelle enthalten ist, muss ein lokales Attribut oder ein UUID-Attribut angegeben werden.

Beispiele

uuid(6B29FC40-CA47-1067-B31D-00DD010662DA) 
 
uuid("6B29FC40-CA47-1067-B31D-00DD010662DA")

Weitere Informationen

IDL-Datei (Interface Definition)

Schnittstelle

lokal

object

/osf

Version