ClearPropVariantArray 関数 (propvarutil.h)

配列に格納されている PROPVARIANT 構造体の配列で使用されるメモリと参照を解放します。

構文

PSSTDAPI_(void) ClearPropVariantArray(
  [in] PROPVARIANT *rgPropVar,
  [in] UINT        cVars
);

パラメーター

[in] rgPropVar

型: PROPVARIANT*

解放する PROPVARIANT 構造体の配列。

[in] cVars

型: UINT

rgPropVar で指定された配列内の要素の数。

戻り値

戻り値はありません。

注釈

この関数は、構造体を 0 に設定する前に、配列内の各構造体によって保持されているメモリと参照を解放します。

この関数は FreePropVariantArray と同じアクションを実行しますが、 FreePropVariantArray は HRESULT を返します。

例

次の例は、より大きなプログラムの一部として含まれるように、ClearPropVariantArray を使用する方法を示しています

// PROPVARIANT rgpropvar[5];
// Assume all 5 propvariants are initialized and valid.

ClearPropVariantArray(rgpropvar, ARRAYSIZE(rgpropvar));

要件

こちらもご覧ください

ClearVariantArray