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 を常に設定します。

構造体を使用する前に、 VariantInit コンポーネント オブジェクト モデル (COM) 関数を呼び出して初期化します。 構造体が完了したら、 VARIANT を含むメモリが VariantClear を呼び出して解放される前に、構造体をクリアします。