progid

Spécifie le ProgID pour un objet COM.

Syntaxe

[ progid(name) ];

Paramètres

nom
ProgID représentant l’objet.

Les progID présentent une version lisible par l’homme de l’identificateur de classe (CLSID) utilisée pour identifier les objets COM/ActiveX.

Notes

L’attribut progid C++ vous permet de spécifier le ProgID pour un objet COM. Un ProgID a le nom1.name2.version du formulaire. Si vous ne spécifiez pas de version pour un ProgID, la version par défaut est 1. Si vous ne spécifiez pas name1.name2, le nom par défaut est classname.classname. Si vous ne spécifiez progid pas et que vous spécifiez vi_progid, name1.name2 sont extraits vi_progid et la version (numéro séquentiel suivant) est ajoutée.

Si un bloc d’attributs qui utilise n’utilise progid uuidpas non plus, le compilateur vérifie le Registre pour voir s’il existe un uuid bloc d’attributs pour le fichier spécifié progid. Si progid elle n’est pas spécifiée, la version (et le nom de coclasse, si la création d’une coclasse) est utilisée pour générer un progid.

progidimplique l’attributcoclass, autrement dit, si vous spécifiez progid, c’est la même chose que de spécifier les attributs et progid les coclass attributs.

L’attribut progid entraîne l’inscription automatique d’une classe sous le nom spécifié. Le fichier .idl généré n’affiche pas la progid valeur.

Lorsque cet attribut est utilisé dans un projet qui utilise ATL, le comportement de l’attribut change. En plus du comportement ci-dessus, les informations spécifiées avec cet attribut sont utilisées dans la GetProgID fonction, injectées par l’attribut coclass . Pour plus d’informations, consultez l’attribut de coclasse .

Exemple

Consultez l’exemple de coclasse pour obtenir un exemple d’utilisation de progid.

Spécifications

Contexte d’attribut Valeur
S’applique à class, struct
Renouvelable Non
Attributs requis Aucune
Attributs non valides Aucune

Pour plus d'informations sur les contextes d'attribut, consultez Contextes d'attribut.

Voir aussi

Attributs IDL
Attributs de classe
Attributs Typedef, Enum, Union et Struct
Clé ProgID