FreePropVariantArray

FreePropVariantArray 関数は、rgvars 配列内の各 PROPVARIANT 構造体に対して PropVariantClear を呼び出し、配列の各メンバの値をゼロにする。

FreePropVariantArray cVariants, rgvars

cVariants : [int] PROPVARIANT 配列（rgvars）の要素数。
rgvars : [var] 解放可能な要素を解放する対象となる、初期化済みの PROPVARIANT 構造体の配列へのポインタ。関数終了時、PROPVARIANT 構造体にはすべて 0 が書き込まれる（これにより VT_EMPTY としてタグ付けされる）。

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

解説

FreePropVariantArray 関数は、rgvars 配列内の各 PROPVARIANT 構造体に対して
PropVariantClear を呼び出し、配列の各メンバの値をゼロにする。

[戻り値]
この関数は HRESULT を返す。

[備考]
FreePropVariantArray は PROPVARIANT 構造体の配列に対して PropVariantClear
を呼び出し、すべての有効なメンバをクリアする。有効な PROPVARIANT 構造体はすべて解放される。配列内のいずれかの
PROPVARIANT 構造体が不正な VT 型を含む場合、有効なメンバは解放され、関数は STG_E_INVALIDPARAMETER
を返す。rgvars に NULL を渡すことは合法であり、戻り値 S_OK が返される。

情報