#import 指令 (C++)

  • 项目

C++ 专用

过去一直合并类型库中的信息。 类型库的内容将转换为 C++ 类，主要描述 COM 接口。

语法

#import "filename" [attributes]
#import<filename> [attributes]

参数

filename
指定要导入的类型库。 filename 可以是下列类型之一：

  • 包含类型库的文件的名称，如 .olb、.tlb 或 .dll 文件。 每个文件名之前可以放置关键字 file:。

  • 类型库中控件的 progid。 每个 progid 之前可以放置关键字 progid:。 例如：

    #import "progid:my.prog.id.1.5"

    有关 progid 的详细信息，请参阅指定本地化 ID 和版本号。

    在 64 位操作系统上使用 32 位交叉编译器时，编译器只能读取 32 位注册表配置单元。 您可能需要使用本机 64 位编译器才能生成和注册 64 位类型库。

  • 类型库的库 ID。 每个库 ID 前可以放置关键字 libid:。 例如：

    #import "libid:12341234-1234-1234-1234-123412341234" version("4.0") lcid("9")

    如果未指定 version 或 lcid，则应用到 progid: 的规则也应用到 libid:。

  • 可执行 (.exe) 文件。

  • 包含类型库资源（例如 .ocx）的库 (.dll) 文件。

  • 包含类型库的复合文档。

  • 可由 LoadTypeLib API 理解的任何其他文件格式。

attributes
一个或多个 #import 特性。 用空格或逗号分隔每个特性。 例如：

#import "..\drawctl\drawctl.tlb" no_namespace, raw_interfaces_only

- 或者 -

#import "..\drawctl\drawctl.tlb" no_namespace raw_interfaces_only

备注

文件名的搜索顺序

filename 后可跟目录规范（可选）。 文件名必须命名现有文件。 两种语法形式之间的差异在于预处理器在未完整指定路径时搜索类型库文件的顺序。

语法形式 操作
带引号的形式 指示预处理器首先在包含 #import 语句的文件目录中查找类型库文件，然后在包含 (#include) 该文件的任何文件目录中查找类型库文件。 然后预处理器沿如下所示的路径执行搜索。
尖括号形式 指示预处理器沿下列路径搜索类型库文件：

1. PATH 环境变量路径列表
2. LIB 环境变量路径列表
3. /I 编译器选项指定的路径，但该编译器搜索从另一具有 no_registry 特性的类型库引用的类型库。

指定本地化 ID 和版本号

指定 progid 时，还可以指定 progid 的本地化 ID 和版本号。 例如：

#import "progid:my.prog.id" lcid("0") version("4.0)

如果未指定本地化 ID，则根据下列规则选择 progid：

  • 如果只有一个本地化 ID，则使用这一个。

  • 如果有多个本地化 ID，则使用第一个版本号为 0、9 或 409 的本地化 ID。

  • 如果有多个本地化 ID，而它们都不为 0、9 或 409，则使用最后一个本地化 ID。

  • 如果未指定版本号，则使用最新版本。

通过导入创建的头文件

#import 将创建两个头文件以重新构造 C++ 源代码内的类型库内容。 主头文件类似于 Microsoft 接口定义语言 (MIDL) 编译器生成的文件，但具有附加的编译器生成的代码和数据。 主头文件具有与类型库相同的基名称以及 .TLH 扩展。 次头文件具有与类型库相同的基名称以及 .TLI 扩展。 它包含编译器生成的成员函数的实现，并且包含 (#include) 在主头文件中。

如果导入一个使用 byref 参数的调度接口属性，则 #import 不会为函数生成 __declspec(属性) 语句。

两个头文件都放置在 /Fo（名称对象文件）选项指定的输出目录中。 然后它们由编译器进行读取和编译，就像 #include 指令命名主头文件一样。

下列编译器优化伴随 #import 指令出现：

  • 头文件在创建后将给定与类型库相同的时间戳。

  • 处理 #import 时，编译器首先会检查头文件是否存在并且是否为最新。 如果是，则不需要重新创建。

#import 指令也参与最小重新生成并可放置在预编译头文件中。 有关详细信息，请参阅创建预编译头文件。

主类型库头文件

主类型库头文件包含 7 个部分：

  • 标题样本：包含注释、COMDEF.H（定义标头中使用的一些标准宏）的 #include 语句和其他杂项安装信息。

  • 转发引用和 typedef：包含结构声明（例如 struct IMyInterface 和 typedef）。

  • 智能指针声明：模板类 _com_ptr_t 是智能指针。 它封装接口指针，因此无需调用 AddRef、Release 和 QueryInterface 函数。 它还会在创建新 COM 对象时隐藏 CoCreateInstance 调用。 本节使用宏语句 _COM_SMARTPTR_TYPEDEF 将 COM 接口的 typedef 建立为 _com_ptr_t 模板类的模板专用化。 例如，对于接口 IMyInterface，.TLH 文件将包含：

    _COM_SMARTPTR_TYPEDEF(IMyInterface, __uuidof(IMyInterface));

    编译器可将其扩展为：

    typedef _com_ptr_t<_com_IIID<IMyInterface, __uuidof(IMyInterface)> > IMyInterfacePtr;

    然后类型 IMyInterfacePtr 可以代替原始的接口指针 IMyInterface* 使用。 因此，无需调用各种 IUnknown 成员函数

  • Typeinfo 声明：主要包含类定义和其他公开 ITypeLib:GetTypeInfo 返回的各个 typeinfo 项的项。 在本节中，类型库中每个 typeinfo 都会反映在标头中，具体形式取决于 TYPEKIND 信息。

  • 可选旧式 GUID 定义：包含名为 GUID 常量的初始化。 这些名称采用 CLSID_CoClass 和 IID_Interface 形式，与 MIDL 编译器生成的类似。

  • 用于次要类型库标头的 #include 语句。

  • 页脚样本：当前包含 #pragma pack(pop)。

除标题样本和页脚样本部分之外的所有部分都封装在其名称由原始 IDL 文件中的 library 语句定义的命名空间中。 可以使用类型库标头的名称，只需使用命名空间名称进行显式限定即可。 也可以包括以下语句：

using namespace MyLib;

在源代码中紧跟在 #import 语句之后。

可使用 #import 指令的 no_namespace 特性禁止显示命名空间。 但是，禁止显示命名空间可能会导致名称冲突。 还可通过 rename_namespace 特性重命名命名空间。

编译器提供了至其当前处理的类型库所需的任何类型库依赖项的完整路径。 路径是以注释形式写入编译器为每个已处理的类型库生成的类型库标头 (.TLH) 中的。

如果类型库包括对其他类型库中所定义类型的引用，则 .TLH 文件将包括下列顺序的注释：

//
// Cross-referenced type libraries:
//
//  #import "c:\path\typelib0.tlb"
//

#import 注释中的实际文件名为交叉引用类型库存储在注册表中的完整路径。 如果遇到因缺少类型定义而导致的错误，请检查位于 .TLH 头处的注释来了解需要先导入的依赖类型库。 错误可能是语法错误（例如，C2143、C2146、C2321）、C2501（缺少声明说明符）或者编译 .TLI 时的 C2433（数据声明上不允许“inline”）。

若要解决依赖项错误，请确定系统标头未以其他形式规定的依赖项注释，接着在某一时刻提供 #import 指令，然后再提供依赖类型库的 #import 指令。

#import 属性

#import 可以选择性地包含一个或多个特性。 这些特性通知编译器修改类型库标头的内容。 反斜杠 (\) 符号可以用于在单个 #import 语句中包括附加行。 例如：

#import "test.lib" no_namespace \
   rename("OldName", "NewName")

有关详细信息，请参阅 #import 特性。

END C++ 专用

另请参阅

预处理器指令
编译器 COM 支持