Application.HinstancePtr-Eigenschaft (Excel)

  • Artikel

Gibt ein Handle für die Instanz von Excel zurück, die durch das angegebene Application-Objekt dargestellt wird. Schreibgeschützter Variant-Wert.

Syntax

Ausdruck. HinstancePtr

expression Eine Variable, die ein Application-Objekt darstellt.

Bemerkungen

Diese Eigenschaft gibt sowohl in der 32-Bit- als auch in der 64-Bit-Version von Excel ein korrektes Handle zurück. Es erweitert die Funktionalität der Hinstance-Eigenschaft des Application-Objekts , die nur in der 32-Bit-Version von Excel ordnungsgemäß funktioniert.

Der ideale Datentyp für die Verwendung mit dieser Eigenschaft ist der LongPtr-Datentyp . Das Zuweisen des von dieser Eigenschaft zurückgegebenen Werts zu einer LongPtr-Variablen funktioniert sowohl in 32-Bit- als auch in 64-Bit-Versionen von Excel erwartungsgemäß. Die Eigenschaft wird aus internen Implementierungsgründen als Variant definiert. Es gibt jedoch immer einen 32-Bit-Wert auf 32-Bit-Systemen und einen 64-Bit-Wert auf 64-Bit-Systemen zurück.

Diese Eigenschaft funktioniert nur ab Excel und ist nur für die 64-Bit-Version von Excel erforderlich. Wenn Sie Code schreiben müssen, der auch mit früheren Versionen von Excel funktioniert, um Kompilierungsfehler zu vermeiden, lesen Sie diese Eigenschaft unter einer #if Win64 Anweisung für die bedingte Kompilierung, und verwenden Sie die Hinstance-Eigenschaft unter der #else -Direktive.

Beachten Sie, dass diese Eigenschaft sowohl in 32-Bit- als auch in 64-Bit-Umgebungen ab Excel einwandfrei funktioniert. Wenn Ihr Code daher nur mit Excel oder höher verwendet werden soll, entweder 32-Bit oder 64-Bit, kann er diese Eigenschaft ohne bedingte Kompilierung lesen.

Weitere Informationen zur Verwendung von VBA in 64-Bit-Umgebungen finden Sie unter Übersicht über 64-Bit-Visual Basic for Applications.

Beispiel

In diesem Beispiel zeigt ein Meldungsfeld dem Benutzer das Handle der Excel-Instanz an.

Sub CheckHinstance() 
    MsgBox Application.HinstancePtr 
End Sub

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.