Compatibilidade entre as versões de 32 bits e 64 bits do Office

Artigo
04/03/2023

Descubra como a versão de 32 bits do Office é compatível com a versão de 64 bits do Office.

Os aplicativos do Office estão disponíveis nas versões de 32 e 64 bits.

As versões de 64 bits do Office permitem mover mais dados para aumentar a capacidade, por exemplo, quando você trabalha com números grandes no Microsoft Excel 2010. Ao escrever código de 32 bits, é possível usar a versão de 64 bits do Office sem qualquer alteração. No entanto, ao escrever código de 64 bits, você deverá garantir que ele contenha palavras-chave específicas e constantes de compilação condicional para garantir que o código tenha compatibilidade com a versão anterior do Office e que o código correto esteja sendo executado se você combinar os códigos de 32 bits e 64 bits.

O Visual Basic for Applications 7.0 (VBA 7) é lançado nas versões de 64 bits para Office e funciona com aplicativos de 32 bits e 64 bits. As alterações descritas neste artigo aplicam-se apenas às versões de 64 bits do Office. Usar as versões de 32 bits do Microsoft Office permite usar soluções criadas em versões anteriores do Office sem modificações adicionais.

Observação

Por padrão, ao instalar uma versão de 64 bits do Office, você não pode instalar a versão de 32 bits junto com ela. Você deve selecionar explicitamente a opção de instalação da versão de 64 bits do Microsoft Office.

No VBA 7, você deve atualizar as instruções existentes da API do Windows (instruções Declare) para trabalhar com a versão de 64 bits. Além disso, você deve atualizar os ponteiros de endereço e exibir alças de janela em tipos definidos pelo usuário que são usadas por estas instruções. Isso é discutido mais detalhadamente neste artigo, bem como os problemas de compatibilidade entre as versões de 32 bits e 64 bits e as soluções sugeridas.

Comparando os sistemas de 32 bits e 64 bits

Os aplicativos criados com as versões de 64 bits do Office podem fazer referência a espaços de endereço maiores que as versões de 32 bits. Isso significa que é possível usar mais memória física para dados do que antes, possivelmente reduzindo a sobrecarga da movimentação de dados da memória física

Além de se referir a locais específicos (conhecidos como ponteiros) na memória física, você também pode usar endereços para fazer referência a identificadores de janela de exibição (conhecidos como alças). O tamanho (em bytes) do ponteiro ou alça depende se você estiver usando um sistema de 32 bits ou 64 bits.

Se você desejar executar as soluções existentes com as versões de 64 bits do Office, lembre-se das seguintes opções:

Os processos de 64 bits nativos no Office não podem carregar binários de 32 bits. Isso é um problema comum quando você tem controles do ActiveX da Microsoft e suplementos existentes.
O VBA anteriormente não tinha um tipo de dados de ponteiro; portanto, você precisava usar variáveis de 32 bits para armazenar ponteiros e alças. Essas variáveis agora truncam valores de 64 bits retornados por chamadas de API ao usar instruções do Declare.

Base de código do VBA 7

O VBA 7 substitui a base de código do VBA no Office 2007 e em versões anteriores. O VBA 7 está disponível em ambas as versões de 32 bits e 64 bits do Office. Ele fornece duas constantes de compilação condicional:

VBA7 - Ajuda a garantir a compatibilidade com versões anteriores do seu código testando se seu aplicativo está usando o VBA 7 ou a versão anterior.
Win64 - Testa se o código está sendo executado como 32 bits ou 64 bits.

Com determinadas exceções, as macros em um documento que funcionam na versão de 32 bits do aplicativo também funcionam na versão de 64 bits.

Compatibilidade com controle ActiveX e suplemento de COM

Os controles do ActiveX de 32 bits existentes não são compatíveis com as versões de 64 bits do Office. Para controles ActiveX e objetos COM:

Se você tiver o código-fonte, gere uma versão de 64 bits por conta própria.
Se não tiver o código-fonte, peça uma versão atualizada ao fornecedor.

Os processos de 64 bits nativos no Office não podem carregar binários de 32 bits. Isso inclui os controles comuns de MSComCtl (TabStrip, Toolbar, StatusBar, ProgressBar, TreeView, ListViews, ImageList, Slider, ImageComboBox) e os controles de MSComCt2 (Animation, UpDown, MonthView, DateTimePicker, FlatScrollBar). Esses controles foram instalados pelas versões de 32 bits do Office anteriores ao Office 2010. Você precisará localizar uma alternativa para as soluções existentes do VBA que usam esses controles quando migrar o código para as versões de 64 bits do Office.

Compatibilidade de API

A combinação de VBA e das bibliotecas de tipo oferece diversas funcionalidades para criar aplicativos do Office. No entanto, às vezes, você deve se comunicar diretamente com o sistema operacional do computador e outros componentes, como quando você gerencia memória ou processos, ao trabalhar com elementos de interface de usuário como janelas e controles, ou ao modificar o registro do Windows. Nessas situações, sua melhor opção é usar uma das funções externas incorporados em arquivos DLL. Para fazer isso no VBA, faça chamadas de API usando instruções Declare.

Observação

A Microsoft fornece um arquivo Win32API.txt que contém 1.500 instruções Declare e uma ferramenta para copiar a instrução Declare que você desejar para o seu código. No entanto, essas instruções são para os sistemas de 32 bits e devem ser convertidas para 64 bits, usando as informações discutidas posteriormente neste artigo. As instruções Declare existentes não compilarão no VBA de 64 bits até que tenham sido marcadas como seguras para 64 bits, usando o atributo PtrSafe. Você pode localizar exemplos desse tipo de conversão no site de Jan Karel Pieterse, MVP de Excel: https://www.jkp-ads.com/articles/apideclarations.asp. O Guia do usuário do Inspetor de compatibilidade de código do Office é uma ferramenta útil para inspecionar a sintaxe de instruções Declare da API do atributo PtrSafe, se necessário, e o tipo de retorno apropriado.

As instruções Declare são semelhantes ao seguinte, dependendo se você está chamando uma sub-rotina (que não tem valor de retorno) ou uma função (que tem um valor de retorno).

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

A função SubName ou FunctionName é substituída pelo nome real do procedimento no arquivo DLL e representa o nome usado quando o procedimento é chamado do código do VBA. Você também pode especificar um argumento AliasName para o nome do procedimento. O nome do arquivo DLL que contém o procedimento que está sendo chamado segue a palavra-chave Lib. E, finalmente, a lista de argumentos contém os parâmetros e os tipos de dados que devem ser passados ao procedimento.

A instrução Declare a seguir abre uma subchave no registro do Windows e substitui seu valor.

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

A entrada Windows.h (alça da janela) para a função RegOpenKeyA é a seguinte:

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

No Visual C e no Microsoft Visual C++, o exemplo anterior compila corretamente para 32 bits e 64 bits. Isso ocorre porque HKEY está definida como um ponteiro cujo tamanho reflete o tamanho da memória da plataforma na qual o código é compilado.

Em versões anteriores do VBA, não havia nenhum tipo de dados de ponteiro específico de modo que o tipo de dados Long era usado. E como o tipo de dados Long sempre é 32 bits, ocorre falha quando é usado em um sistema com memória de 64 bits, porque os 32 bits de cima podem ser truncados ou podem substituir outros endereços de memória. Cada uma destas situações pode resultar em comportamentos imprevisíveis ou falhas de sistema.

Para resolve isso, o VBA inclui um verdadeiro tipo de dados de ponteiro: LongPtr. Esse novo tipo de dados permite que você escreva a instrução Declare original corretamente da seguinte maneira:

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

Esse tipo de dados e o novo atributo PtrSafe permitem que você use esta instrução Declare em sistemas de 32 bits ou 64 bits. O atributo PtrSafe indica para o compilador de VBA que a instrução Declare está direcionada para a versão de 64 bits do Office. Sem esse atributo, usar a instrução Declare em um sistema de 64 bits resultará em um erro em tempo de compilação. O atributo PtrSafe é opcional na versão de 32 bits do Office. Isso permite que instruções Declare existentes funcionem como de costume.

A tabela a seguir fornece mais informações sobre o novo qualificador e os tipos de dados bem como outro tipo de dados, dois operadores de conversão e três funções.

Tipo	Item	Descrição
Qualificador	PtrSafe	Indica que a instrução Declare é compatível com 64 bits. Esse atributo é obrigatório em sistemas de 64 bits.
Tipo de dados	LongPtr	Um tipo de dados da variável que é um tipo de dados de 4 bytes em versões de 32 bits e um tipo de dados de 8 bytes em versões de 64 bits do Microsoft Office. Essa é a maneira recomendada de declarar um ponteiro ou uma alça do novo código, mas também para código herdado se ele tiver para executar a versão de 64 bits do Office. Só é suportado no tempo de execução do VBA 7 de 32 bits e 64 bits. Você pode atribuir valores numéricos a ele, mas não tipos numéricos.
Tipo de dados	LongLong	Esse é um tipo de dados de 8 bytes que está disponível somente em versões de 64 bits do Microsoft Office. Você pode atribuir valores numéricos, mas não tipos numéricos (para evitar truncamento).
Operador de conversão	CLngPtr	Converte uma expressão simples em um tipo de dados LongPtr.
Operador de conversão	CLngLng	Converte uma expressão simples em um tipo de dados LongLong.
Função	VarPtr	Conversor variante. Retorna um LongPtr em versões de 64 bits e um Long em versões de 32 bits (4 bytes).
Função	ObjPtr	Conversor de objeto. Retorna um LongPtr em versões de 64 bits e um Long em versões de 32 bits (4 bytes).
Função	StrPtr	Conversor de cadeia de caracteres. Retorna um LongPtr em versões de 64 bits e um Long em versões de 32 bits (4 bytes).

O exemplo a seguir mostra como usar alguns desses itens em uma instrução Declare.

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

As instruções Declare sem o atributo PtrSafe são consideradas não compatíveis com a versão de 64 bits do Office.

Há duas constantes de compilação condicional: VBA7 e Win64. Para garantir a compatibilidade com versões anteriores do Microsoft Office, você usa a constante VBA7 (esse é o caso mais comum) para impedir o código de 64 bits de ser usado na versão anterior do Office. Para código que é diferente entre a versão de 32 bits e a de 64 bits, como chamar uma API matemática que usa LongLong para sua versão de 64 bits e Long para sua versão de 32 bits, você usa a constante Win64. O código a seguir mostra o uso de duas dessas constantes.

#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

Para resumir, se você escreve código de 64 bits e pretende usá-lo em versões anteriores do Office, convém usar a constante de compilação condicional VBA7. No entanto, se você escrever código de 32 bits no Office, esse código funcionará como nas versões anteriores do Office sem a necessidade da constante de compilação. Se você deseja garantir que está usando instruções de 32 bits para versões de 32 bits e instruções de 64 bits para versões de 64 bits, a melhor opção é usar a constante de compilação condicional Win64.

Usar atributos de compilação condicional

O exemplo a seguir mostra o código VBA escrito para 32 bits que precisa ser atualizado. Observe os tipos de dados no código legado que são atualizados para usar LongPtr porque se referem a identificadores ou ponteiros.

Código VBA escrito para versões de 32 bits

Declare Function SHBrowseForFolder Lib "shell32.dll" _
  Alias "SHBrowseForFolderA" (lpBrowseInfo As BROWSEINFO) As LongPtr
  
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

Código VBA reescrito para versões de 64 bits

#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&amp;
    bInfo.ulFlags = &amp;H1
    pidList = SHBrowseForFolder(bInfo)
End Sub

Perguntas frequentes

Quando devo usar a versão de 64 bits do Office?

Isso é mais uma questão de qual aplicativo host (Excel, Word e assim por diante) você está usando. Por exemplo, o Excel é capaz de manipular planilhas muito maiores com a versão de 64 bits do Microsoft Office.

Posso instalar versões de 32 bits e 64 bits do Office lado a lado?

Não.

Quando devo converter parâmetros de Long para LongPtr?

Você precisa verificar a documentação da API do Windows na rede de desenvolvedores da Microsoft para a função que deseja chamar. Ponteiros e alças precisam ser convertidos para LongPtr. Por exemplo, a documentação para RegOpenKeyA fornece a assinatura a seguir.

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

Os parâmetros são definidos como:

Parâmetro	Descrição
hKey [in]	Uma alça para uma chave do Registro aberta.
lpSubKey [in, optional]	O nome da subchave de registro a ser aberta.
ulOptions	Esse parâmetro está reservado e deve ser zero.
samDesired [in]	Uma máscara que especifica os direitos de acesso desejado para a chave.
phkResult [out]	Um ponteiro para uma variável que recebe uma alça para a chave aberta.

No Win32API_PtrSafe.txt, a instrução Declare é definida como:

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

Posso converter ponteiros e alças em estruturas?

Sim. Confira o tipo MSG em Win32API_PtrSafe.txt:

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

Quando devo usar strptr varpt e objptr?

Você deve usar essas funções para recuperar ponteiros para cadeias de caracteres, variáveis e objetos, respectivamente. Na versão de 64 bits do Office, essas funções retornarão um LongPtr de 64 bits, que pode ser passado para instruções Declare. O uso dessas funções não mudou de versões anteriores do VBA. A única diferença é que elas agora retornam um LongPtr.

Confira também

Anatomy of a Declare Statement