propVariantCopy 函式 (combaseapi.h)

PropVariantCopy 函式會將一個 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 函式會如此。 對於非簡單 PROPVARIANT 類型，例如VT_STREAM、VT_STORAGE等，需要子物件，則會以傳址方式建立複本。 系統會複製指標，並在其上呼叫 IUnknown：：AddRef 。 針對 pvarDest 或 pvarSrc 傳遞 NULL 不合法。

規格需求

另請參閱

PROPVARIANT、 PropVariantClear