VARIANT-Struktur

Die meisten Microsoft Active Accessibility-Funktionen und die IAccessible-Eigenschaften und -Methoden verwenden eine VARIANT-Struktur als Parameter. Im Wesentlichen ist die VARIANT-Struktur ein Container für eine große Union, die viele Datentypen enthält.

Der Wert im ersten Member der -Struktur vt beschreibt, welcher der Union-Member gültig ist. Obwohl die VARIANT-Struktur viele verschiedene Datentypen unterstützt, verwendet Microsoft Active Accessibility nur die folgenden Typen.

vt-Wert	Entsprechender Wertmembername
VT_I4	lVal
VT_DISPATCH	pdispVal
VT_BSTR	bstrVal
VT_EMPTY	Keine

 

Wenn Sie Informationen in einer VARIANT-Struktur erhalten, überprüfen Sie das vt-Element , um herauszufinden, welches Element gültige Daten enthält. Wenn Sie Informationen mithilfe einer VARIANT-Struktur senden, legen Sie vt immer so fest, dass er den Union-Member widerspiegelt, der die Informationen enthält.

Bevor Sie die -Struktur verwenden, initialisieren Sie sie, indem Sie die Com-Funktion (VariantInit Component Object Model) aufrufen. Wenn Sie mit der Struktur fertig sind, löschen Sie sie, bevor der Arbeitsspeicher, der den VARIANT enthält, durch Aufrufen von VariantClear freigegeben wird.