Share via


_Application.HinstancePtr Property

Gets a handle to the instance of Microsoft Excel 2010 represented by the specified _Application object.

Namespace:  Microsoft.Office.Interop.Excel
Assembly:  Microsoft.Office.Interop.Excel (in Microsoft.Office.Interop.Excel.dll)

Syntax

'Declaration
ReadOnly Property HinstancePtr As Object
    Get
'Usage
Dim instance As _Application
Dim value As Object

value = instance.HinstancePtr
Object HinstancePtr { get; }

Property Value

Type: System.Object
A handle to the instance of Microsoft Excel 2010 represented by the specified _Application object.

Remarks

Read-only Variant.

This property returns a correct handle in both the 32- and 64-bit versions of Excel. It extends the functionality of the Hinstance property of the _Application object, which only works correctly in the 32-bit version of Excel.

The ideal data type to use with this property is the LongPtr data type. Assigning the value returned by this property to a LongPtr variable will work as expected in both 32- and 64-bit versions of Excel. The property is defined as Variant for internal implementation reasons. However, it always returns a 32-bit value on 32-bit systems and a 64-bit value on 64-bit systems.

This property only works starting with Excel 2010, and is only required with the 64-bit version of Excel. If you must write code that will also work with earlier versions of Excel, in order to avoid compilation errors, read this property under an #if Win64 conditional compilation directive, and use the Hinstance property under the #else directive.

Note

This property works fine in both 32- and 64-bit environments starting with Excel 2010. Therefore, if your code is intended to be used only with Excel 2010 or later, either 32- or 64-bit, it can read this property without conditional compilation.

See Also

Reference

_Application Interface

_Application Members

Microsoft.Office.Interop.Excel Namespace