ClearPropVariantArray 関数 (propvarutil.h)

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

構文

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

[in] rgPropVar

解放する 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));

要件	値
サポートされている最小のクライアント	WINDOWS XP と SP2、Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 SP1 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	propvarutil.h
Library	Propsys.lib
[DLL]	Propsys.dll (バージョン 6.0 以降)
再頒布可能パッケージ	Windows デスクトップ検索 (WDS) 3.0