Структура VARIANT

Большинство функций Microsoft Active Accessibility и свойств и методов IAccessible принимают структуру VARIANT в качестве параметра. По сути, структура VARIANT — это контейнер для большого объединения, который содержит множество типов данных.

Значение в первом элементе структуры, vt, описывает, какой из членов объединения действителен. Хотя структура VARIANT поддерживает множество различных типов данных, Microsoft Active Accessibility использует только следующие типы.

Значение vt Соответствующее имя элемента значения
VT_I4 lVal
VT_DISPATCH pdispVal
VT_BSTR bstrVal
VT_EMPTY none

 

При получении сведений в структуре VARIANT проверьте элемент vt , чтобы узнать, какой элемент содержит допустимые данные. Аналогичным образом при отправке данных с помощью структуры VARIANT всегда задается значение vt , чтобы отразить член объединения, содержащий сведения.

Перед использованием структуры инициализируйте ее, вызвав функцию COM.COM. Завершив работу со структурой, очистите ее до освобождения памяти, содержащей VARIANT , путем вызова VariantClear.