SafeArrayCreate 関数 (oleauto.h)

新しい配列記述子を作成し、配列のデータを割り当てて初期化し、新しい配列記述子へのポインターを返します。

構文

SAFEARRAY * SafeArrayCreate(
  [in] VARTYPE        vt,
  [in] UINT           cDims,
  [in] SAFEARRAYBOUND *rgsabound
);

パラメーター

[in] vt

配列の基本型 (配列の各要素の VARTYPE)。 VARTYPE は、バリアント型のサブセットに制限されます。 VT_ARRAYフラグもVT_BYREFフラグも設定できません。 VT_EMPTYとVT_NULLは、配列の有効な基本型ではありません。 その他の種類はすべて有効です。

[in] cDims

配列の次元数。 配列の作成後に数値を変更することはできません。

[in] rgsabound

配列に割り当てる境界のベクトル (次元ごとに 1 つ)。

戻り値

安全な配列記述子。配列を作成できなかった場合は null。

要件