32 位和 64 位版本的 Office 2010 之间的兼容性

  • 项目

**摘要：**针对处理 2GB 或更多数据的客户，Microsoft Office 2010 现在作为 64 位版本提供。本文讨论有关 32 位版本与新的 64 位版本和旧的 32 位 Office 应用程序之间兼容性的问题，并提供了相应的解决方案。（7 个打印页）

上次修改时间： 2015年4月24日

适用范围： Excel 2010 | Office 2007 | Office 2010 | Open XML | PowerPoint 2010 | SharePoint Server 2010 | VBA | Visual Basic for Applications 7.0 (VBA 7.0) | Word 2010

本文内容
介绍 32 位和 64 位版本的 Microsoft Office 2010
将 32 位系统与 64 位系统进行比较
介绍 VBA 7 基本代码
ActiveX 控件和 COM 加载项兼容性
应用程序编程接口兼容性
使用条件编译属性
常见问题
结论
其他资源

Applies to:   Microsoft Office 2010

**发布时间：**2010 年 3 月

**供稿人：**Microsoft Corporation

内容

  • 介绍 32 位和 64 位版本的 Microsoft Office 2010

  • 将 32 位系统与 64 位系统进行比较

  • 介绍 VBA 7 基本代码

  • ActiveX 控件和 COM 加载项兼容性

  • 应用程序编程接口兼容性

  • 使用条件编译属性

  • 常见问题

  • 结论

  • 其他资源

介绍 32 位和 64 位版本的 Microsoft Office 2010

Microsoft Office 2010 system 同时具有 32 位和 64 位版本。64 位版本使您能够处理更大的数据集。如果要在 Microsoft Excel 2010 中处理大量数字，则尤其需要使用此版本。

随着新的 64 位版本 Microsoft Office 2010 的引入，Microsoft 发布了称为 Microsoft Visual Basic for Applications 7.0 (VBA 7) 的新版本的 Microsoft Visual Basic for Applications (VBA) 以同时处理 32 位和 64 位应用程序。需要特别注意的是，本文中介绍的更改只适用于 64 位版本的 Microsoft Office 2010。如果使用的是 32 位版本的 Office 2010，则可以不加修改地使用以前版本的 Microsoft Office 中内置的解决方案。

备注

在安装 Office 2010 时，默认安装的是 32 位版本，即使在 64 位系统上也是如此。您必须明确 选择 Office 2010 64 位版本安装选项。

在 VBA 7 中，必须更新现有 Windows 应用程序编程接口 (API) 语句（Declare 语句）才能处理 64 位版本。另外，还必须更新这些语句使用的用户定义类型中的地址指针和显示窗口句柄。本文将详细讨论这一点以及 32 位和 64 位版本的 Office 2010 之间的兼容性问题，并提供建议的解决方案。

将 32 位系统与 64 位系统进行比较

使用 64 位版本的 Office 2010 构建的应用程序可以引用更大的地址空间，因此提供了使用比以往更多的物理内存的机会，从而有可能减少将数据移入和移出物理内存所需的开销。

除了引用应用程序用于存储数据或存储编程指令的物理内存中的特定位置（又称为指针）外，还可以使用地址来引用显示窗口标识符（称为句柄）。根据您使用的是 32 位系统还是 64 位系统，可确定指针或句柄的大小（以字节为单位）。

在使用 64 位版本的 Office 2010 运行现有解决方案时存在两个基本问题：

  • Office 2010 中的本机 64 位进程无法加载 32 位二进制文件。在使用现有 Microsoft ActiveX 控件和现有加载项时，这被认为是一个常见问题，

  • VBA 以前不具有指针数据类型，因此，开发人员使用 32 位变量来存储指针和句柄。但现在在使用 Declare 语句时，这些变量会截断 API 调用返回的 64 位值。

介绍 VBA 7 基本代码

VBA 7 是新的基本代码，取代了早期版本的 VBA。32 位和 64 位版本的 Office 2010 中均包含 VBA 7。它提供了两个条件编译常量：VBA7 和 Win64。通过测试您的应用程序使用的是 VBA 7 还是以前版本的 VBA，VBA7 常量可帮助确保您的代码的后向兼容性。Win64 常量用于测试代码是以 32 位还是 64 位形式运行的。下文将介绍这两个编译常量。

本文中的其他部分介绍了一些例外情况，当在应用程序的 64 位版本中加载文档时，该文档（还包括工作簿和演示文稿）中使用该应用程序的 32 位版本创建的宏也适用。

ActiveX 控件和 COM 加载项兼容性

第三方及 Microsoft 提供的现有 32 位 ActiveX 控件与 64 位版本的 Office 2010 不兼容。对于 ActiveX 控件和 COM 对象，有三种可能的解决方案：

  • 如果您有源代码，则可以自己生成 64 位版本，

  • 您可以与供应商联系以获取更新版本，

  • 也可以搜索其他解决方案。

Office 2010 中的本机 64 位进程无法加载 32 位二进制文件。这包括 MSComCtl 的常见控件（TabStrip、Toolbar、StatusBar、ProgressBar、TreeView、ListViews、ImageList、Slider、ImageComboBox）和 MSComCt2 的控件（Animation、UpDown、MonthView、DateTimePicker、FlatScrollBar）。这些控件以前由之前版本的 Microsoft Office 安装，现在由 32 位 Office 2010 安装。必须找到现有 Microsoft Office VBA 解决方案的一种替代方法，以便在代码迁移到 64 位 Office 2010 后利用这些控件。64 位 Office 2010 不提供常见控件的 64 位版本。

应用程序编程接口兼容性

VBA 和类型库的结合为您提供了许多用于创建 Microsoft Office 应用程序的功能。不过，有时，您必须直接与计算机的操作系统及其他组件进行通信，例如在您管理内存或进程时，在使用用户界面（例如窗口和控件）时，或在修改 Windows 注册表时。在这些情况下，最好选择使用一个嵌入动态链接库 (DLL) 文件中的外部函数。为此，可在 VBA 中使用 Declare 语句进行 API 调用。

备注

Microsoft 提供了一个 Win32API.txt 文件，其中包含 1,500 个 Declare 语句以及一个用于剪切所需 Declare 语句并将其粘贴到您的代码中的工具。不过，这些语句适用于 32 位系统，必须使用下文讨论的信息将其转换为 64 位。现有 Declare 语句在 64 位 VBA 中不会进行编译，直到使用 PtrSafe 属性将它们标记为对 64 位安全。您可以在 Excel MVP Jan Karel Pieterse 的网站 http://www.jkp-ads.com/articles/apideclarations.asp 上找到此类型的转换示例。

Office 代码兼容性检查器用户指南是一种有用的工具，可用于检查 API Declare 语句的语法以查看 PtrSafe 属性以及（如有必要）相应的返回类型。

Declare 语句类似于以下代码之一，具体取决于您调用的是子例程（没有返回值）还是函数（有返回值）。

  Public/Private Declare Sub SubName Lib "LibName" Alias "AliasName" (argument list)
  Public/Private Declare Function FunctionName Lib "Libname" alias "aliasname" (argument list) As Type

SubName 函数或 FunctionName 函数会被替换为 DLL 文件中过程的实际名称，表示在从 VBA 代码调用过程时所使用的名称。如果需要，您还可以为过程名称指定 AliasName 参数。包含要调用的过程的 DLL 文件的名称位于 Lib 关键字之后。最后，参数列表将包含必须传递给该过程的参数和数据类型。

下面的 Declare 语句将打开 Windows 注册表中的一个子项 并替换其值。

  Declare Function RegOpenKeyA Lib "advapi32.dll" (ByVal Key As Long, ByVal SubKey As String, NewKey As Long) As Long

RegOpenKeyA 函数的 Windows.h（窗口句柄）条目如下所示：

  LONG RegOpenKeyA ( HKEY hKey, LPCSTR lpSubKey, HKEY *phkResult );

在 Microsoft Visual C 和 Microsoft Visual C++ 中，前面的示例对 32 位和 64 位都能够正确编译。这是因为 HKEY 定义为指针，其大小反映了在其中编译代码的平台的内存大小。

在以前版本的 VBA 中，没有特定指针数据类型，因此使用了 Long 数据类型，而 Long 数据类型始终为 32 位，所以它在具有 64 位内存的系统上使用时会发生中断，因为前 32 位可能被截断或可能覆盖其他内存地址。以上任一情况都会导致不可预测的行为或系统崩溃。

为解决此问题，VBA 现在包含真正的指针 数据类型 LongPtr。此新数据类型使您能够正确编写原始 Declare 语句，如下所示：

  Declare PtrSafe Function RegOpenKeyA Lib "advapire32.dll" (ByVal hKey as LongPtr, ByVal lpSubKey As String, phkResult As LongPtr) As Long

此数据类型和新的 PtrSafe 属性使您能够在 32 位或 64 位系统上使用此 Declare 语句。PtrSafe 属性向 VBA 编译器指示 Declare 语句面向 64 位版本的 Office 2010。如果不使用此属性，那么在 64 位系统中使用 Declare 语句会导致编译时错误。请注意，PtrSafe 属性在 32 位版本的 Office 2010 上是可选的。这使现有 Declare 语句始终能够正常运行。

下表提供了有关已讨论过的新限定符和数据类型以及另一种数据类型、两个转换运算符和三个函数的详细信息。

类型

项

说明

限定符

PtrSafe

指示 Declare 语句与 64 位兼容。此属性在 64 位系统上是必需的。

数据类型

LongPtr

一种变量数据类型，在 32 位版本的 Office 2010 上是 4 字节数据类型，在 64 位版本上是 8 字节数据类型。这是为新代码声明指针或句柄的推荐方法，但如果它必须运行在 64 位版本的 Office 2010 中，则也为旧代码声明指针或句柄。只有 32 位和 64 位上的 VBA 7 运行时支持此数据类型。请注意，您可以为它赋予数值，但不能赋予数值类型。

数据类型

LongLong

这是只能在 64 位版本的 Office 2010 中使用的 8 字节数据类型。您可以赋予数值，但不能赋予数值类型（以避免截断）。

转换运算符

CLngPtr

将简单表达式转换为 LongPtr 数据类型。

转换运算符

CLngLng

将简单表达式转换为 LongLong 数据类型。

函数

VarPtr

变量转换器。在 64 位版本上返回 LongPtr，在 32 位版本上返回 Long（4 字节）。

函数

ObjPtr

对象转换器。在 64 位版本上返回 LongPtr，在 32 位版本上返回 Long（4 字节）。

函数

StrPtr

字符串转换器。在 64 位版本上返回 LongPtr，在 32 位版本上返回 Long（4 字节）。

下面的示例演示如何在 Declare 语句中使用其中某些项。

  Declare PtrSafe Function RegOpenKeyA Lib "advapi32.dll" (ByVal Key As LongPtr, ByVal SubKey As String, NewKey As LongPtr) As Long

请注意，没有 PtrSafe 属性的 Declare 语句被假定为与 64 位版本的 Office 2010 不兼容。

如前所述，有两个新的条件编译常量：VBA7 和 Win64。为确保与以前版本的 Microsoft Office 的向后兼容性，可使用 VBA7 常量（这是较典型的情况）来防止 64 位代码在早期版本的 Microsoft Office 中运行。对于在 32 位版本和 64 位版本之间有所不同的代码（例如调用数学 API，它对其 64 位版本使用 LongLong，对其 32 位版本使用 Long），可使用 Win64 常量。下面的代码演示如何使用这两个常量。

  #if Win64 then
     Declare PtrSafe Function MyMathFunc Lib "User32" (ByVal N As LongLong) As LongLong
  #else
     Declare Function MyMathFunc Lib "User32" (ByVal N As Long) As Long
  #end if
  #if VBA7 then
     Declare PtrSafe Sub MessageBeep Lib "User32" (ByVal N AS Long)
  #else
     Declare Sub MessageBeep Lib "User32" (ByVal N AS Long)
  #end if

总而言之，如果您编写 64 位代码并打算在以前版本的 Microsoft Office 中使用它，则需要使用 VBA7 条件编译常量。不过，如果您在 Office 2010 中编写 32 位代码，则该代码的工作方式与在以前版本的 Microsoft Office 中一样，无需使用编译常量。如果希望确保对 32 位版本使用 32 位语句，对 64 位版本使用 64 位语句，则最好选择使用 Win64 条件编译常量。

使用条件编译属性

下面的代码是需要更新的旧 VBA 代码的示例。请注意旧代码中更新为使用 LongPtr 的数据类型，因为它们引用句柄或指针

旧 VBA 代码

  Declare Function SHBrowseForFolder Lib "shell32.dll" _
    Alias "SHBrowseForFolderA" (lpBrowseInfo As BROWSEINFO) As Long
    
  Public Type BROWSEINFO
    hOwner As Long
    pidlRoot As Long
    pszDisplayName As String
    lpszTitle As String
    ulFlags As Long
    lpfn As Long
    lParam As Long
    iImage As Long
  End Type

新 VBA 代码

  #if VBA7 then    ' VBA7 
  Declare PtrSafe Function SHBrowseForFolder Lib "shell32.dll" _
    Alias "SHBrowseForFolderA" (lpBrowseInfo As BROWSEINFO) As Long
  
  Public Type BROWSEINFO
    hOwner As LongPtr
    pidlRoot As Long
    pszDisplayName As String
    lpszTitle As String
    ulFlags As Long
    lpfn As LongPtr
    lParam As LongPtr
    iImage As Long
  End Type
   
  #else    ' Downlevel when using previous version of VBA7
  
  Declare Function SHBrowseForFolder Lib "shell32.dll" _
    Alias "SHBrowseForFolderA" (lpBrowseInfo As BROWSEINFO) As Long
  
  Public Type BROWSEINFO
    hOwner As Long
    pidlRoot As Long
    pszDisplayName As String
    lpszTitle As String
    ulFlags As Long
    lpfn As Long
    lParam As Long
    iImage As Long
  End Type
   
  #end if
  Sub TestSHBrowseForFolder ()
      Dim bInfo As BROWSEINFO
      Dim pidList As Long
  
      bInfo.pidlRoot = 0&
      bInfo.ulFlags = &H1
      pidList = SHBrowseForFolder(bInfo)
  End Sub

常见问题

下面是与 Microsoft Office 32 位版本和 64 位版本相关的常见问题。

  • 何时应该使用 64 位版本的 Microsoft Office？
    这与您使用哪个主机应用程序（Excel、Word 等）有关。例如，Excel 可以使用 Microsoft Office 的 64 位版本处理大得多的数据表。

  • 可以同时安装 Microsoft Office 的 64 位和 32 位版本吗？
    不能。

  • 何时应将 Long 参数转换为 LongPtr？
    您需要查看 Microsoft 开发人员网络上的 Windows API 文档，了解您想要调用的函数。句柄和指针需转换为 LongPtr。例如，RegOpenKeyA 文档中提供了以下签名：

    LONG WINAPI RegOpenKeyEx(
  __in        HKEY hKey,
  __in_opt    LPCTSTR lpSubKey,
  __reserved  DWORD ulOptions,
  __in        REGSAM samDesired,
  __out       PHKEY phkResult
);

    参数的定义如下：

    参数

    说明

    hKey [in]

    用于打开注册表项的句柄。

    lpSubKey [in, optional]

    要打开的注册表子项的名称。

    ulOptions

    此参数需保留，并且必须是零。

    samDesired [in]

    指定对密钥的所需访问权限的掩码。

    phkResult [out]

    用于接收打开的密钥的句柄的变量指针。

    在 Win32API_PtrSafe.txt 中，Declare 语句定义为：

    Declare PtrSafe Function RegOpenKeyEx Lib "advapi32.dll" Alias "RegOpenKeyExA" (ByVal hKey As LongPtr, ByVal lpSubKey As String, ByVal ulOptions As Long, ByVal samDesired As Long, phkResult As LongPtr) As Long

  • 是否应该转换结构中的指针和句柄？
    是。请参阅 Win32API_PtrSafe.txt 中的 MSG 类型：

    Type MSG
    hwnd As LongPtr
    message As Long
    wParam As LongPtr
    lParam As LongPtr
    time As Long
    pt As POINTAPI
End TypeF

  • 何时应该使用 strptr、varpt 和 objptr？
    您应使用这些函数来分别检索字符串、变量和对象的指针。在 Microsoft Office 的 64 位版本上，这些函数将返回可以传递到 Declare 语句的 64 位 LongPtr。这些函数的用法与 VBA 的之前版本相比没有变化。唯一的区别是他们现在可以返回 LongPtr。

结论

增加了 64 位版本的 Office 2010 后，您可以移动更多数据来增强功能。编写 32 位代码时，可以使用 64 位版本的 Microsoft Office 而无需进行任何更改。不过，在编写 64 位代码时，应确保您的代码包含特定关键字和条件编译常量，以确保代码与早期版本的 Microsoft Office 向后兼容，并确保在混合 32 位和 64 位代码时执行了正确的代码。

其他资源

有关 Declare 语句的详细信息，请参阅以下资源：