IStream：：Clone 方法 (objidl.h)
Clone 方法會使用自己的搜尋指標建立新的數據流物件，以參考與原始數據流相同的位元組。
語法
HRESULT Clone(
[out] IStream **ppstm
);
參數
[out] ppstm
成功時，指向新數據流物件 之 IStream 指標位置的指標。 如果發生錯誤，此參數為 NULL。
傳回值
這個方法可以傳回下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
| S_OK | 已成功複製數據流。 |
| E_PENDING | 僅限異步記憶體：目前無法使用部分或所有數據流的數據。 |
| STG_E_INSUFFICIENTMEMORY | 數據流因為記憶體不足而未複製。 |
| STG_E_INVALIDPOINTER | ppStm 指標無效。 |
| STG_E_REVERTED | 物件已因交易樹狀結構中上方的還原作業而失效。 |
備註
Clone 方法會建立新的數據流物件，以存取相同的位元組，但使用不同的搜尋指標。 新的數據流物件會看到與來源數據流物件相同的數據。 寫入至某個物件的變更會立即顯示在另一個物件中。 範圍鎖定會在數據流對象之間共用。
複製數據流實例中搜尋指標的初始設定，與複製作業時原始數據流中搜尋指標的目前設定相同。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | objidl.h |
| 程式庫 | Uuid.lib |
| Dll | Ole32.dll |