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

こちらもご覧ください

PropVariantClear