Propriedade Application.HinstancePtr (Excel)

Devolve um identificador para a instância do Excel representada pelo objeto de Aplicação especificado. Somente leitura Variant.

Sintaxe

expressão. HinstancePtr

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

Comentários

Esta propriedade devolve uma alça correta nas versões de 32 bits e 64 bits do Excel. Expande 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 utilizar com esta propriedade é o tipo de dados LongPtr . Atribuir o valor devolvido por esta propriedade a uma variável LongPtr funcionará conforme 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..

Esta propriedade só funciona a partir do Excel e só é necessária com a versão de 64 bits do Excel. Se tiver de escrever código que também funcione com versões anteriores do Excel, para evitar erros de compilação, leia esta propriedade sob uma #if Win64 diretiva de compilação condicional e utilize a propriedade Hinstance ao abrigo da #else diretiva .

Tenha em atenção que esta propriedade funciona bem em ambientes de 32 bits e de 64 bits a partir do Excel. Por conseguinte, se o seu código se destinar a ser utilizado apenas com o Excel ou posterior, de 32 bits ou de 64 bits, pode ler esta propriedade sem compilação condicional.

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

Exemplo

Neste exemplo, uma caixa de mensagem apresenta o identificador da instância do Excel ao utilizador.

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.