vi_progid

Gibt eine versionsunabhängige Form der ProgID an.

Syntax

[ vi_progid(name) ];

Parameter

name
Die versionsunabhängige ProgID, die das Objekt darstellt.

ProgIDs stellen eine lesbare Version des Klassenbezeichners (CLSID) dar, die zum Identifizieren von COM/ActiveX-Objekten verwendet wird.

Hinweise

Mit dem vi_progid C++-Attribut können Sie eine versionsunabhängige ProgID für ein COM-Objekt angeben. Eine ProgID weist den Formularnamen1.name2.version auf. Eine versionsunabhängige ProgID verfügt nicht über eine Version. Es ist möglich, sowohl die progid Attribute als auch die vi_progid Attribute für ein coclass. Wenn Sie vi_progid nicht angeben, ist die versionsunabhängige ProgID der durch das progid-Attribut angegebene Wert.

vi_progid impliziert das coclass Attribut, d. h. wenn Sie vi_progid angeben, ist es dasselbe wie das Angeben der coclass Attribute und vi_progid Attribute.

Das attribut vi_progid bewirkt, dass eine Klasse automatisch unter dem angegebenen Namen registriert wird. Die generierte IDL-Datei zeigt nicht den ProgID-Wert an.

Wenn das Coclass-Attribut auch in ATL-Projekten vorhanden ist, wird die angegebene ProgID von der GetVersionIndependentProgID Funktion verwendet (eingefügt durch das coclass Attribut).

Beispiel

Sehen Sie sich das Coclass-Beispiel für eine Beispielverwendung von vi_progid an.

Anforderungen

Attributkontext	Wert
Gilt für	class, struct
Wiederholbar	Nein
Erforderliche Attribute	None
Ungültige Attribute	None

Weitere Informationen zu den Attributkontexten finden Sie unter Attributkontexte.

Siehe auch

IDL-Attribute
typedef-, enum-, union- und struct-Attribute
Klassenattribute
ProgID-Schlüssel