Freigeben über


uuid-Attribut

Das [uuid]- Schnittstellenattribute gibt einen universally unique Identifier (UUID) an, der der Schnittstelle zugewiesen ist und sie von anderen Schnittstellen unterscheidet.

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

Parameter

string-uuid

Gibt eine Zeichenfolge aus 8 Hexadezimalstellen gefolgt von einem Bindestrich, dann drei Gruppen von 4 Hexadezimalstellen jeweils gefolgt von einem Bindestrich und dann 12 Hexadezimalstellen an. Sie können die UUID-Zeichenfolge in Anführungszeichen einschließen, außer wenn Sie den MIDL-Compilerschalter /osf verwenden.

Bemerkungen

Die Laufzeitbibliothek verwendet die Vom Attribut [uuid] festgelegte Schnittstellen-UUID, um die Kommunikation zwischen client- und Serveranwendungen herzustellen. Das [uuid] -Attribut kann in der Liste der Schnittstellenattribute für eine RPC-Schnittstelle oder eine COM-Schnittstelle angezeigt werden.

Für eine RPC-Schnittstelle muss die Schnittstellenattributeliste entweder das [uuid] -Attribut oder das [local] -Attribut enthalten, und das von Ihnen ausgewählte Attribut muss genau einmal vorkommen. Wenn die Liste das Attribut [uuid] enthält, kann sie auch das [version] -Attribut enthalten.

Für eine COM-Schnittstelle (identifiziert durch das [object]- Schnittstellenattribute) muss die Schnittstellenattributeliste das Attribut [uuid] enthalten, darf aber nicht das [version] -Attribut enthalten. Die Liste für eine COM-Schnittstelle kann das Attribut [local] enthalten, obwohl das Attribut [uuid] vorhanden ist.

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

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

Die UUID und die Versionsnummern der Schnittstelle werden verwendet, um zu bestimmen, ob der Client an den Server binden 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 in der Schnittstelle auch nur eine Prozedur enthalten ist, muss ein lokales Oder 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

Objekt

/Osf

Version