Partilhar via

Propriedade Application.HinstancePtr (Excel)

  • Artigo

Retorna um identificador para a instância do Excel representada pelo objeto Application especificado. Somente leitura Variant.

Sintaxe

expressão. HinstancePtr

expressão Uma variável que representa um Aplicativo objeto.

Comentários

Essa propriedade retorna um identificador correto nas versões de 32 bits e 64 bits do Excel. Ele estende a funcionalidade da propriedade Hinstance do objeto Application , que só funciona corretamente na versão de 32 bits do Excel.

O tipo de dados ideal a ser usado com essa propriedade é o tipo de dados LongPtr . Atribuir o valor retornado por essa propriedade a uma variável LongPtr funcionará conforme o esperado nas versões de 32 bits e 64 bits do Excel. A propriedade é definida como Variant por motivos de implementação interna. No entanto, ela sempre retornará um valor de 32 bits em sistemas de 32 bits e um valor de 64 bits em sistemas de 64 bits..

Essa propriedade funciona apenas a partir do Excel e só é necessária com a versão de 64 bits do Excel. Se você precisar escrever um código que também funcione com versões anteriores do Excel, para evitar erros de compilação, leia essa propriedade em uma #if Win64 diretiva de compilação condicional e use a propriedade Hinstance sob a #else diretiva.

Observe que essa propriedade funciona bem em ambientes de 32 bits e 64 bits começando com o Excel. Portanto, se o código for destinado a ser usado somente com o Excel ou posterior, de 32 bits ou 64 bits, ele poderá ler essa propriedade sem compilação condicional.

Para obter mais informações sobre como usar o VBA em ambientes de 64 bits, confira Visão geral Visual Basic for Applications de 64 bits.

Exemplo

Neste exemplo, uma caixa de mensagem exibe o identificador de instância do Excel para o usuário.

Sub CheckHinstance() 
    MsgBox Application.HinstancePtr 
End Sub

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.