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 不合法。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | combaseapi.h |
| 程式庫 | Ole32.lib |
| Dll | Ole32.dll |