VARIANT – struktura

Většina funkcí Microsoft Active Accessibility a vlastností IAccessible metody používají jako parametr strukturu VARIANT. Struktura VARIANT je v podstatě kontejner pro velkou sjednocení, která nese mnoho typů dat.

Hodnota v prvním členu struktury, vt, popisuje, které členy sjednocení jsou platné. Přestože struktura VARIANT podporuje mnoho různých datových typů, microsoft Active Accessibility používá pouze následující typy.

hodnota vt	Odpovídající název člena hodnoty
VT_I4	lVal
VT_DISPATCH	pdispVal
VT_BSTR	bstrVal
VT_EMPTY	žádný

 

Když obdržíte informace ve struktuře VARIANT, zkontrolujte člen vt a zjistěte, který člen obsahuje platná data. Podobně když odesíláte informace pomocí struktury VARIANT, vždy nastavte vt tak, aby odrážel člena sjednocení, který obsahuje informace.

Před použitím struktury ji inicializujete voláním funkce VariantInit Component Object Model (COM). Po dokončení struktury jej vymažte před pamětí, která obsahuje VARIANT je uvolněna voláním VariantClear.