_Application.HinstancePtr Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets a handle to the instance of Microsoft Excel 2010 represented by the specified _Application object.
public:
property System::Object ^ HinstancePtr { System::Object ^ get(); };public object HinstancePtr { get; }Public ReadOnly Property HinstancePtr As ObjectProperty Value
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.