C#调用DLL中 DllImport属性详解（一）

现在是更深入地进行探讨的时候了。在对托管代码进行 P/INVOKE 调用时，DLLIMPORTATTRIBUTE 类型扮演着重要的角色。DLLIMPORTATTRIBUTE 的主要作用是给 CLR 指示哪个 DLL 导出您想要调用的函数。相关 DLL 的名称被作为一个构造函数参数传递给 DLLIMPORTATTRIBUTE。

如果您无法肯定哪个 DLL 定义了您要使用的 WINDOWS API 函数，PLATFORM SDK 文档将为您提供最好的帮助资源。在 WINDOWS API 函数主题文字临近结尾的位置，SDK 文档指定了 C 应用程序要使用该函数必须链接的 .LIB 文件。在几乎所有的情况下，该 .LIB 文件具有与定义该函数的系统 DLL 文件相同的名称。例如，如果该函数需要 C 应用程序链接到 KERNEL32.LIB，则该函数就定义在 KERNEL32.DLL 中。您可以在 MESSAGEBEEP 中找到有关 MESSAGEBEEP 的 PLATFORM SDK 文档主题。在该主题结尾处，您会注意到它指出库文件是 USER32.LIB；这表明 MESSAGEBEEP 是从 USER32.DLL 中导出的。

可选的 DLLIMPORTATTRIBUTE 属性

除了指出宿主 DLL 外，DLLIMPORTATTRIBUTE 还包含了一些可选属性，其中四个特别有趣：ENTRYPOINT、CHARSET、SETLASTERROR 和 CALLINGCONVENTION。

ENTRYPOINT 在不希望外部托管方法具有与 DLL 导出相同的名称的情况下，可以设置该属性来指示导出的 DLL 函数的入口点名称。当您定义两个调用相同非托管函数的外部方法时，这特别有用。另外，在 WINDOWS 中还可以通过它们的序号值绑定到导出的 DLL 函数。如果您需要这样做，则诸如“#1”或“#129”的 ENTRYPOINT 值指示 DLL 中非托管函数的序号值而不是函数名。

CHARSET 对于字符集，并非所有版本的 WINDOWS 都是同样创建的。WINDOWS 9X 系列产品缺少重要的 UNICODE 支持，而 WINDOWS NT 和 WINDOWS CE 系列则一开始就使用 UNICODE。在这些操作系统上运行的 CLR 将UNICODE 用于 STRING 和 CHAR 数据的内部表示。但也不必担心 — 当调用 WINDOWS 9X API 函数时，CLR 会自动进行必要的转换，将其从 UNICODE转换为 ANSI。

如果 DLL 函数不以任何方式处理文本，则可以忽略 DLLIMPORTATTRIBUTE 的 CHARSET 属性。然而，当 CHAR 或 STRING 数据是等式的一部分时，应该将 CHARSET 属性设置为 CHARSET.AUTO。这样可以使 CLR 根据宿主 OS 使用适当的字符集。如果没有显式地设置 CHARSET 属性，则其默认值为 CHARSET.ANSI。这个默认值是有缺点的，因为对于在 WINDOWS 2000、WINDOWS XP 和 WINDOWS NT® 上进行的 INTEROP 调用，它会消极地影响文本参数封送处理的性能。

应该显式地选择 CHARSET.ANSI 或 CHARSET.UNICODE 的 CHARSET 值而不是使用 CHARSET.AUTO 的唯一情况是：您显式地指定了一个导出函数，而该函数特定于这两种 WIN32 OS 中的某一种。READDIRECTORYCHANGESW API 函数就是这样的一个例子，它只存在于基于 WINDOWS NT 的操作系统中，并且只支持 UNICODE；在这种情况下，您应该显式地使用 CHARSET.UNICODE。

有时，WINDOWS API 是否有字符集关系并不明显。一种决不会有错的确认方法是在 PLATFORM SDK 中检查该函数的 C 语言头文件。（如果您无法肯定要看哪个头文件，则可以查看 PLATFORM SDK 文档中列出的每个 API 函数的头文件。）如果您发现该 API 函数确实定义为一个映射到以 A 或 W 结尾的函数名的宏，则字符集与您尝试调用的函数有关系。WINDOWS API 函数的一个例子是在 WINUSER.H 中声明的 GETMESSAGE API，您也许会惊讶地发现它有 A 和 W 两种版本。

SETLASTERROR 错误处理非常重要，但在编程时经常被遗忘。当您进行 P/INVOKE 调用时，也会面临其他的挑战 — 处理托管代码中 WINDOWS API 错误处理和异常之间的区别。 可以给您一点建议。

如果您正在使用 P/INVOKE 调用 WINDOWS API 函数，而对于该函数，您使用 GETLASTERROR 来查找扩展的错误信息，则应该在外部方法的 DLLIMPORTATTRIBUTE 中将 SETLASTERROR 属性设置为 TRUE。这适用于大多数外部方法。

这会导致 CLR 在每次调用外部方法之后缓存由 API 函数设置的错误。然后，在包装方法中，可以通过调用类库的 SYSTEM.RUNTIME.INTEROPSERVICES.MARSHAL 类型中定义的 MARSHAL.GETLASTWIN32ERROR 方法来获取缓存的错误值。 的建议是检查这些期望来自 API 函数的错误值，并为这些值引发一个可感知的异常。对于其他所有失败情况（包括根本就没意料到的失败情况），则引发在 SYSTEM.COMPONENTMODEL 命名空间中定义的 WIN32EXCEPTION，并将 MARSHAL.GETLASTWIN32ERROR 返回的值传递给它。如果您回头看一下图 1 中的代码，您会看到 在 EXTERN MESSAGEBEEP 方法的公共包装中就采用了这种方法。

CALLINGCONVENTION  将在此介绍的最后也可能是最不重要的一个 DLLIMPORTATTRIBUTE 属性是 CALLINGCONVENTION。通过此属性，可以给 CLR 指示应该将哪种函数调用约定用于堆栈中的参数。CALLINGCONVENTION.WINAPI 的默认值是最好的选择，它在大多数情况下都可行。然而，如果该调用不起作用，则可以检查 PLATFORM SDK 中的声明头文件，看看您调用的 API 函数是否是一个不符合调用约定标准的异常 API。

通常，本机函数（例如 WINDOWS API 函数或 C- 运行时 DLL 函数）的调用约定描述了如何将参数推入线程堆栈或从线程堆栈中清除。大多数 WINDOWS API 函数都是首先将函数的最后一个参数推入堆栈，然后由被调用的函数负责清理该堆栈。相反，许多 C-运行时 DLL 函数都被定义为按照方法参数在方法签名中出现的顺序将其推入堆栈，将堆栈清理工作交给调用者。

幸运的是，要让 P/INVOKE 调用工作只需要让外围设备理解调用约定即可。通常，从默认值 CALLINGCONVENTION.WINAPI 开始是最好的选择。然后，在 C 运行时 DLL 函数和少数函数中，可能需要将约定更改为 CALLINGCONVENTION.CDECL。