_Application.HinstancePtr Propriedade

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Obtém um identificador para a instância de Microsoft Excel 2010 representada pelo objeto especificado_Application.

public:
 property System::Object ^ HinstancePtr { System::Object ^ get(); };

public object HinstancePtr { get; }

Public ReadOnly Property HinstancePtr As Object

Valor da propriedade

Object

Um identificador para a instância de Microsoft Excel 2010 representada pelo objeto especificado_Application.

Comentários

Somente leitura Variant.

Essa propriedade retorna um identificador correto nas versões de 32 e 64 bits do Excel. Ele estende a funcionalidade da Hinstance propriedade do _Application objeto, 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. A atribuição do valor retornado por essa propriedade para uma variável LongPtr funcionará como esperado nas versões de 32 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 2010 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 esta propriedade em uma diretiva de compilação condicional #if Win64 e use a Hinstance propriedade na diretiva #else.

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