VariantChangeType

variant をある型から別の型に変換する。

VariantChangeType pvargDest, pvarSrc, wFlags, vt

pvargDest : [var] 変換先の variant。pvarSrc と同じ場合、variant はその場で変換される。
pvarSrc : [var] 変換する variant。
wFlags : [int] フラグ。
vt : [int] 変換先の型。戻り値が S_OK の場合、*pvargDest の vt フィールドはこの値と等しいことが保証される。

(プラグイン / モジュール : oleaut32.dll)

解説

variant をある型から別の型に変換する。

[戻り値]
次のいずれかの値を返すことがある。
（以下省略）

[備考]
VariantChangeType 関数は基本型間の型変換 (数値から文字列、文字列から数値への変換を含む) を扱う。pvarSrc
引数は変換処理中に変更される。例えば、ソース variant が VT_BOOL 型で変換先が VT_UINT 型の場合、pvarSrc
引数はまず VT_I2 に変換され、その後変換が進められる。VT_BYREF が設定されている variant
は、参照先の値を取得することで値に変換される。オブジェクトはオブジェクトの Value プロパティ (DISPID_VALUE)
を呼び出すことで値に変換される。通常、IDispatch::Invoke の実装者はアクセスされているメンバを判断し、その後 1
つ以上の引数の値を取得するために VariantChangeType を呼び出す。例えば、IDispatch 呼び出しが文字列引数を 1
つ取る SetTitle メンバを指定している場合、実装者は引数を VT_BSTR に強制変換するために
VariantChangeType を呼び出す。VariantChangeType がエラーを返さなければ、引数を VARIANTARG
の bstrVal フィールドから直接取得できる。VariantChangeType が DISP_E_TYPEMISMATCH
を返した場合、実装者は *puArgErr に 0 を設定し (エラーのある引数を示す)、Invoke から
DISP_E_TYPEMISMATCH を返す。この関数では、ある型の配列を別の型の配列に変換することはできない。注意
VARIANTARG の型を rgvarg 配列内でその場で変更してはならない。

情報