FreePropVariantArray 関数 (combaseapi.h)
FreePropVariantArray 関数は、rgvars 配列の PROPVARIANT 構造体ごとに PropVariantClear を呼び出して、配列の各メンバーの値を 0 にします。
構文
HRESULT FreePropVariantArray(
[in] ULONG cVariants,
[in] PROPVARIANT *rgvars
);
パラメーター
[in] cVariants
PROPVARIANT 配列 (rgvars) 内の要素の数。
[in] rgvars
割り当て解除可能な要素を解放する PROPVARIANT 構造体の初期化された配列へのポインター。 終了時に、すべてのゼロが PROPVARIANT 構造体に書き込まれます (したがって、VT_EMPTYとしてタグ付けされます)。
戻り値
この関数は HRESULT を返します。
注釈
FreePropVariantArray は、PROPVARIANT 構造体の配列で PropVariantClear を呼び出して、有効なすべてのメンバーをクリアします。 有効なすべての PROPVARIANT 構造体が解放されます。 いずれかの PROPVARIANT 構造体に無効な VT 型が含まれている場合、有効なメンバーは解放され、関数はSTG_E_INVALIDPARAMETERを返します。
rgvars に NULL を渡すことは有効であり、S_OKのリターン コードを生成します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
対象プラットフォーム | Windows |
ヘッダー | combaseapi.h |
Library | Ole32.lib |
[DLL] | Ole32.dll |