Структура VARIANT

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

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

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

 

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

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