VARIANT, struktura

Większość funkcji microsoft Active Accessibility i IAccessible właściwości i metody przyjmują VARIANT strukturę jako parametr. Zasadniczo struktura VARIANT jest kontenerem dla dużej unii, która przenosi wiele typów danych.

Wartość w pierwszym elemencie struktury vtopisuje, które z składowych unii są prawidłowe. Mimo że struktura VARIANT obsługuje wiele różnych typów danych, usługa Microsoft Active Accessibility używa tylko następujących typów.

wartość vt	Odpowiadająca nazwa elementu członkowskiego wartości
VT_I4	lVal
VT_DISPATCH	pdispVal
VT_BSTR	bstrVal
VT_EMPTY	żaden

 

Po otrzymaniu informacji w strukturze VARIANT sprawdź element członkowski vt, aby dowiedzieć się, który element członkowski zawiera prawidłowe dane. Podobnie podczas wysyłania informacji przy użyciu struktury VARIANT zawsze ustawiaj vt, aby odzwierciedlić składową zawierającą informacje.

Przed użyciem struktury zainicjuj ją, wywołując funkcję VariantInit Component Object Model (COM). Po zakończeniu pracy ze strukturą wyczyść ją, zanim pamięć zawierająca VARIANT zostanie zwolniona, wywołując VariantClear.