progid

Gibt die ProgID für ein COM-Objekt an.

Syntax

[ progid(name) ];

Parameter

name
Die 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 progid dem C++-Attribut können Sie die ProgID für ein COM-Objekt angeben. Eine ProgID weist den Formularnamen1.name2.version auf. Wenn Sie keine Version für eine ProgID angeben, ist die Standardversion 1. Wenn Sie name1.name2 nicht angeben, lautet der Standardname "classname.classname". Wenn Sie nicht angeben progid und angeben vi_progid, werden name1.name2 entnommen vi_progid , und die (nächste sequenzielle Nummer) Version wird angefügt.

Wenn ein Attributblock, progid der nicht auch verwendet uuidwird, überprüft der Compiler die Registrierung, um festzustellen, ob für das angegebene progidAttribut vorhanden uuid ist. Wenn progid nicht angegeben, wird die Version (und der Coclass-Name, wenn eine Coclass erstellt wird) verwendet, um eine progid.

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

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

Wenn dieses Attribut in einem Projekt verwendet wird, das ATL verwendet, ändert sich das Verhalten des Attributs. Zusätzlich zum obigen Verhalten werden die mit diesem Attribut angegebenen Informationen in der GetProgID Funktion verwendet, die vom coclass Attribut eingefügt werden. Weitere Informationen finden Sie im Coclass-Attribut .

Beispiel

Sehen Sie sich das Beispiel für coclass für eine Beispielverwendung von progid.

Anforderungen

Attributkontext	Wert
Gilt für	class, struct
Wiederholbar	No
Erforderliche Attribute	Keine
Ungültige Attribute	Keine

Weitere Informationen zu den Attributkontexten finden Sie unter Attributkontexte.

Siehe auch

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