PropVariantCopy 関数 (combaseapi.h)

PropVariantCopy 関数は、ある PROPVARIANT 構造体の内容を別の PROPVARIANT 構造体にコピーします。

構文

HRESULT PropVariantCopy(
  [in, out] PROPVARIANT       *pvarDest,
  [in]      const PROPVARIANT *pvarSrc
);

パラメーター

[in, out] pvarDest

コピーを受け取る初期化されていない PROPVARIANT 構造体へのポインター。

[in] pvarSrc

コピーする PROPVARIANT 構造体へのポインター。

戻り値

この関数は HRESULT を返します。

注釈

PROPVARIANT 構造体を値でコピーして、元の pvarSrc パラメーターと新しい pvarDest パラメーターを PropVariantClear の呼び出しで個別に解放できるようにします。 PropVariantCopy は 、VariantCopy 関数と同様に変換先を解放しません。 サブオブジェクトを必要とするVT_STREAM、VT_STORAGEなどの非シンプル な PROPVARIANT 型の場合、コピーは参照によって作成されます。 ポインターがコピーされ、 IUnknown::AddRef が呼び出されます。 pvarDest または pvarSrc に NULL を渡すことは無効です。

要件

こちらもご覧ください

PROPVARIANT、 PropVariantClear