Структура VARIANT

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

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

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

 

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

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