SafeArrayRedim 関数 (oleauto.h)

  • [アーティクル]

指定したセーフ配列の右端 (最下位) のバインドを変更します。

構文

HRESULT SafeArrayRedim(
  [in, out] SAFEARRAY      *psa,
  [in]      SAFEARRAYBOUND *psaboundNew
);

パラメーター

[in, out] psa

安全な配列記述子。

[in] psaboundNew

新しい配列境界を含む、新しい安全な配列バインド構造体。 配列の最下位次元のみを変更できます。

戻り値

この関数は、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK
 正常終了しました。
E_INVALIDARG
 引数 psa が無効です。
DISP_E_ARRAYISLOCKED
 配列がロックされています。

注釈

配列の境界を小さくすると、 SafeArrayRedim は新しい配列境界の外側に配列要素の割り当てを解除します。 配列のバインドが増えた場合、 SafeArrayRedim は新しい配列要素を割り当てて初期化します。 データは、古い配列と新しい配列の両方に存在する要素に対して保持されます。

要件

要件 値
対象プラットフォーム Windows
ヘッダー oleauto.h
Library OleAut32.lib
[DLL] OleAut32.dll