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

另請參閱

IStream - 複合檔案實作

IStream::CopyTo