バリアント構造体

Microsoft Active Accessibility のほとんどの関数と IAccessible のプロパティおよびメソッドは、パラメーターとして バリアント 構造体を受け取ります。 基本的に、 バリアント 構造体は、さまざまな種類のデータを格納する大きな共用体のコンテナーです。

構造体の最初のメンバー ( vt) の値は、どの共用体メンバーが有効であるかを示します。 バリアント構造体ではさまざまなデータ型がサポートされていますが、Microsoft Active Accessibility では次の型のみを使用します。

vt 値 対応する値メンバー名
VT _ I4 lVal
VT _ ディスパッチ pdispVal
VT _ BSTR bstrVal
VT _ EMPTY なし

 

バリアント構造体で情報を受信する場合は、 vt メンバーをチェックして、有効なデータが含まれているメンバーを確認します。 同様に、 バリアント 構造体を使用して情報を送信する場合は、その情報を含む共用体メンバーを反映するように、常に vt を設定します。

構造体を使用する前に、 VariantInit Component Object MODEL (COM) 関数を呼び出して初期化します。 構造体の使用が完了したら、 VariantClearを呼び出すことによって、バリアントを含むメモリが解放される前に、この構造体をクリアします。