Freigeben über


progid

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

[ progid( 
   name 
) ];

Parameter

  • Name
    Die ProgID, das das Objekt darstellt.

    ProgIDs-Geschenk einer lesbaren Version der Klassenbezeichner (CLSID) verwendet, um COM-/ActiveX Objekte zu identifizieren.

Hinweise

Das Attribut progid C++ können Sie die ProgID für ein COM-Objekt angeben. Ein ProgID hat das Formular name1.name2.version. Wenn Sie keine Version für eine ProgID angeben, wird die standardmäßige Version 1. Wenn Sie nicht angeben, name1.name2ist der Standardname classname.classname. Wenn Sie nicht angeben progid und Sie vi_progidangeben, werden name1.name2von vi_progid entnommen und die Version (der folgenden sequenziellen Zahl) angefügt wird.

Wenn in einem Attributblock, der progid verwendet, nicht uuidverwendet, überprüft der Compiler die Registrierung, um festzustellen, ob uuid für die angegebene progidvorhanden ist. Wenn progid nicht angegeben wird, werden die Version (und der Co-Klassen, wenn erstellt werden, eine Co-Klasse) verwendet, um progidzu generieren.

Das bedeutetprogid coclass-Attribut, d.h., wenn Sie progidangeben, wird die coclass , wie dasselbe Ziel und progid-Attribute angibt.

Das progid-Attribut wird eine Klasse mit dem angegebenen Namen automatisch registriert werden. Die generierten IDL-Datei wird nicht den progid-Wert an.

Wenn dieses Attribut innerhalb eines Projekts verwendet wird, das ATL verwendet, ändert sich das Verhalten des Attributs. Neben den oben beschriebenen Verhalten sind die Informationen, die mit diesem Attribut angegeben werden, in der GetProgID-Funktion eingefügt, durch das coclass-Attribut. Weitere Informationen finden Sie unter Co-Klasse-Attribut.

Beispiel

Weitere Informationen finden Sie im Beispiel für Co-Klasse B. für eine Verwendung von progid.

Anforderungen

Attribut-Kontext

Betrifft

Klasse, struct

Wiederholbar

Nein

Erforderliche Attribute

None

Ungültige Attribute

None

Weitere Informationen über das kontexte finden Sie unter Attribut-Kontexte.

Siehe auch

Referenz

ProgID Key

Weitere Ressourcen

IDL-Attribute

Klassenattribute

typedef-, enum-, union- und struct-Attribute

Attributes Samples