COleStreamFile Class

 

如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件

表示資料的資料流 ( IStream) 在複合檔案做為 OLE 結構化儲存體的一部分。

class COleStreamFile : public CFile  

公用建構函式

名稱描述
COleStreamFile::COleStreamFile建構 COleStreamFile 物件。

公用方法

名稱描述
COleStreamFile::Attach將資料流與物件相關聯。
COleStreamFile::CreateMemoryStream從全域記憶體中建立的資料流,並將它與物件相關聯。
COleStreamFile::CreateStream建立資料流,並將它與物件相關聯。
COleStreamFile::Detach解除關聯之物件的資料流。
COleStreamFile::GetStream傳回目前資料流。
COleStreamFile::OpenStream安全地開啟資料流,並將它與物件相關聯。

IStorage物件必須存在才能開啟或建立,除非它是記憶體資料流之資料流。

COleStreamFile物件完全相同的操作CFile物件。

如需操作資料流與儲存的詳細資訊,請參閱文章容器︰ 複合檔案...

如需詳細資訊,請參閱IStreamIStorage中Windows SDK。

CObject

CFile

COleStreamFile

標頭︰ afxole.h

將使用提供的 OLE 資料流COleStreamFile物件。

void Attach(LPSTREAM lpStream);

參數

lpStream
指向 OLE 資料流 ( IStream) 與物件相關聯。 不能是NULL

備註

物件已不可 OLE 資料流相關聯。

如需詳細資訊,請參閱IStream中Windows SDK。

建立 COleStreamFile 物件。

COleStreamFile(LPSTREAM lpStream = NULL);

參數

lpStream
要與物件相關聯之 OLE 資料流指標。

備註

如果lpStreamNULL、 物件並不是 OLE 資料流相關聯,否則該物件提供的 OLE 資料流相關聯。

如需詳細資訊,請參閱IStream中Windows SDK。

安全地建立新的資料流通用的共用記憶體不足其中失敗是正常且預期的情況。

BOOL CreateMemoryStream(CFileException* pError = NULL);

參數

pError
指向CFileException物件或NULL ,表示建立作業的完成狀態。 如果您想要監視可能嘗試建立資料流所產生的例外狀況,請提供這個參數。

傳回值

如果成功; 建立資料流,非零值。否則為 0。

備註

由 OLE 子系統所配置的記憶體。

如需詳細資訊,請參閱CreateStreamOnHGlobal中Windows SDK。

提供的儲存體物件,其中失敗是正常且預期的情況中,安全地建立新的資料流。

BOOL CreateStream(
    LPSTORAGE lpStorage,  
    LPCTSTR lpszStreamName,  
    DWORD nOpenFlags = modeReadWrite|shareExclusive|modeCreate,  
    CFileException* pError = NULL);

參數

lpStorage
包含要建立資料流 OLE 儲存物件的指標。 不能是NULL

lpszStreamName
若要建立資料流名稱。 不能是NULL

nOpenFlags
用來開啟資料流的存取模式。 獨佔、 讀取/寫入,並建立模式會使用預設值。 如需可用的模式的完整清單,請參閱CFile::CFile

pError
指向CFileException物件或NULL。 如果您想要監視可能嘗試建立資料流所產生的例外狀況,請提供這個參數。

傳回值

如果成功; 建立資料流,非零值。否則為 0。

備註

如果無法開啟檔案的例外狀況將會擲回和pErrorNULL

如需詳細資訊,請參閱IStorage::CreateStream中Windows SDK。

解除關聯物件的資料流,而不需要關閉資料流。

LPSTREAM Detach();

傳回值

資料流的指標 ( IStream) 是與物件相關聯。

備註

程式終止之前,必須透過其他方式關閉資料流。

如需詳細資訊,請參閱IStream中Windows SDK。

呼叫此函式來傳回目前資料流的指標。

IStream* GetStream() const;  

傳回值

目前資料流介面的指標 ( IStream)。

開啟現有的資料流。

BOOL OpenStream(
    LPSTORAGE lpStorage,  
    LPCTSTR lpszStreamName,  
    DWORD nOpenFlags = modeReadWrite|shareExclusive,  
    CFileException* pError = NULL);

參數

lpStorage
包含要開啟的資料流的 OLE 儲存體物件的指標。 不能是NULL

lpszStreamName
若要開啟資料流名稱。 不能是NULL

nOpenFlags
用來開啟資料流的存取模式。 獨佔和讀/寫模式會使用預設值。 可用的模式的完整清單,請參閱CFile::CFile

pError
指向CFileException物件或NULL。 如果您想要監視可能嘗試開啟資料流所產生的例外狀況,請提供這個參數。

傳回值

如果成功,開啟資料流,則為非零否則為 0。

備註

如果無法開啟檔案的例外狀況將會擲回和pErrorNULL

如需詳細資訊,請參閱IStorage::OpenStream中Windows SDK。

CFile 類別
階層架構圖表

顯示: