PropVariantCopy

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

PropVariantCopy pvarDest, pvarSrc

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

(プラグイン / モジュール : ole32.dll)

解説

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

[戻り値]
この関数は HRESULT を返す。

[備考]
PROPVARIANT 構造体を値でコピーするので、元の pvarSrc と新しい pvarDest パラメータは
PropVariantClear の呼び出しで独立に解放できる。PropVariantCopy は VariantCopy
関数のように宛先を解放しない。VT_STREAM、VT_STORAGE などのサブオブジェクトが必要な非シンプルな PROPVARIANT
型については、コピーは参照によって行われる。ポインタがコピーされ、それに対して
[IUnknown::AddRef](../unknwn/nf-unknwn-iunknown-addref.md)
が呼び出される。pvarDest または pvarSrc のいずれかに NULL を渡すことは違法である。

情報