CONVERT-TO-VARIANT関数（OLE2オートメーションインタフェース機能）

形式

機能: CONVERT-TO-VARIANT（VARIANT値変換）関数は，引数2で指定したCOBOLのデータ項目と等価な引数1で指定した型のVARIANT値へのポインタを返す。この関数は，OLE2オートメーションインタフェース機能を使ったINVOKE文での引数や，SET文での設定値を，特定の型のVARIANT値として扱う場合に使用する。この関数の型は，バリアントデータ型である。

一般規則

引数について
・引数1は，整数項目（結果が常に整数となる算術式を含む），整数定数，表意定数ZEROを指定しなければならない。
・引数1は，変換するVARIANT値の型を示す数値を指定しなければならない。指定する数値とVARIANT値との対応を次に示す。

表18-3　指定する数値とVARIANT値との対応

指定する数値	VARIANT値の型
0	Empty（VT_EMPTY）
1	Null（VT_NULL）
2	整数型（VT_I2）
3	長整数型（VT_I4）
4	単精度浮動小数点型（VT_R4）
5	倍精度浮動小数点型（VT_R8）
6	通貨型（VT_CY）
7	日付型（VT_DATE）
8	文字列型（VT_BSTR）
9	オブジェクト型（VT_DISPATCH）
11	ブール型（VT_BOOL）

決められた数値以外のものが指定されたときの結果は保証しない。
・引数2は，集団項目，数字項目（算術式を含む），数字編集項目，英字項目，英数字項目，日本語項目，1けたのブール項目，OLEオブジェクト参照データ項目，数字定数，英数字定数，日本語文字定数，1けたのブール定数または表意定数（ZERO，NULL）でなければならない。
VARIANT値へ変換できないデータ項目が指定されている場合は，実行時にエラーとなる。
VARIANT値変換では，「表18-1　COBOLデータ項目からVARIANT値への変換規則」に示した変換規則のVARIANT値に合わせてCOBOLデータ項目を指定すること。変換規則で示されていない通貨型，日付型は英数字項目で指定する。なお，日付型は03/01/01 09:00という形式で設定すること。
・引数1に0または1が指定された場合，引数2は無視される。2～11が指定された場合で，引数2が指定されていないときはエラーとなる。
・-UniObjGenオプションを指定した場合，引数2に用途がNATIONALの項目，日本語文字定数および16進日本語文字定数を指定してはならない。-UniObjGenオプションについては，マニュアル「COBOL2002　ユーザーズガイド」のUnicode機能を参照のこと。

関数値について
・関数値は，指定された引数と等価のVARIANT値へのポインタが返される。
関数の表現形式
・VARIANT値へのポインタ
・この関数は，（CALL文，INVOKE文（オブジェクト指向機能），利用者定義関数を除く）送り出し側作用対象となるバリアントデータ項目が指定できるところおよびバリアントデータ比較の条件式に記述できる。

18.5.1 CONVERT-TO-VARIANT関数（OLE2オートメーションインタフェース機能）

18.5.1　CONVERT-TO-VARIANT関数（OLE2オートメーションインタフェース機能）