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