为 COM 对象指定 ProgID。
语法
[ progid(name) ];
参数设置
name
表示对象的 ProgID。
ProgID 提供人工可读取版本的类标识符 (CLSID) 用于标识 COM/ActiveX 对象。
备注
借助 C++ 特性 progid,可为 COM 对象指定 ProgID。 ProgID 采用 name1.name2.version 形式。 如果未为 ProgID 指定版本,则默认版本为 1。 如果未指定 name1.name2,则默认名称为 classname.classname。 如果未指定 progid 并且指定了 vi_progid,则从 vi_progid 获取 name1.name2,并追加(下一个序列号)版本。
如果使用 progid 的特性块不使用 uuid,编译器将检查注册表,查看是否存在 uuid 用于指定的 progid。 如果未指定 progid,则将使用版本(如果创建组件类,则还需要组件类名称)来生成 progid。
progid 暗含 coclass 特性,也就是说,如果指定了 progid,就等于指定了 coclass 和 progid 特性。
progid 特性导致类按指定的名称自动注册。 生成的 .idl 文件不会显示 progid 值。
如果在使用 ATL 的项目中使用此特性,该特性的行为会更改。 除了上述行为外,使用此特性指定的信息还用于 GetProgID 函数,它由 coclass 特性注入。 有关详细信息,请参阅 coclass 特性。
示例
有关 progid 的示例用法,请参阅 coclass 的示例。
要求
| 特性上下文 | 值 |
|---|---|
| 适用于 | %> |
| 可重复 | 否 |
| 必需的特性 | 无 |
| 无效的特性 | 无 |
有关特性上下文的详细信息,请参见 特性上下文。