Megosztás a következőn keresztül:

COleStreamFile osztály

  • Cikk

Egy összetett fájl adatfolyamát (IStream) jelöli az OLE strukturált tároló részeként.

Szintaxis

class COleStreamFile : public CFile

Tagok

Nyilvános konstruktorok

Név Leírás
COleStreamFile::COleStreamFile Egy COleStreamFile objektumot hoz létre.

Nyilvános metódusok

Név Leírás
COleStreamFile::Attach Stream társítása az objektummal.
COleStreamFile::CreateMemoryStream Létrehoz egy streamet a globális memóriából, és társítja azt az objektummal.
COleStreamFile::CreateStream Létrehoz egy streamet, és társítja azt az objektummal.
COleStreamFile::D etach Leválasztja a streamet az objektumról.
COleStreamFile::GetStream Az aktuális streamet adja vissza.
COleStreamFile::OpenStream Biztonságosan megnyitja a streamet, és társítja azt az objektummal.

Megjegyzések

Egy IStorage objektumnak léteznie kell a stream megnyitása vagy létrehozása előtt, kivéve, ha memóriastreamről van szó.

COleStreamFile objektumok kezelése pontosan úgy történik, mint CFile objektumok.

A streamek és a tárolók módosításával kapcsolatos további információkért tekintse meg a tárolók : Összetett fájlokcímű cikket.

További információ: IStream és IStorage a Windows SDK-ban.

Öröklési hierarchia

CObject

CFile

COleStreamFile

Követelmények

fejléc: afxole.h

COleStreamFile::Attach

Társítja a megadott OLE-adatfolyamot a COleStreamFile objektummal.

void Attach(LPSTREAM lpStream);

Paraméterek

lpStream
Az objektumhoz társítandó OLE-adatfolyamra (IStream) mutat. Nem lehet NULL.

Megjegyzések

Az objektumot még nem szabad OLE-adatfolyamhoz társítani.

További információ: IStream a Windows SDK-ban.

COleStreamFile::COleStreamFile

Létrehoz egy COleStreamFile objektumot.

COleStreamFile(LPSTREAM lpStream = NULL);

Paraméterek

lpStream
Mutasson az objektumhoz társítandó OLE-adatfolyamra.

Megjegyzések

Ha lpStream NULL értékű, az objektum nincs OLE-adatfolyamhoz társítva, ellenkező esetben az objektum a megadott OLE-adatfolyamhoz van társítva.

További információ: IStream a Windows SDK-ban.

COleStreamFile::CreateMemoryStream

Biztonságosan létrehoz egy új streamet a globális, megosztott memóriából, ahol a hiba normális, elvárt állapot.

BOOL CreateMemoryStream(CFileException* pError = NULL);

Paraméterek

pError
Egy CFileException objektumra vagy NULL értékre mutat, amely a létrehozási művelet befejezési állapotát jelzi. Adja meg ezt a paramétert, ha a stream létrehozásával létrehozott lehetséges kivételeket szeretné figyelni.

Visszaadott érték

Nonzero, ha a stream sikeresen létrejött; egyéb esetben 0.

Megjegyzések

A memóriát az OLE alrendszer foglalja le.

További információ: CreateStreamOnHGlobal a Windows SDK-ban.

COleStreamFile::CreateStream

Biztonságosan létrehozhat egy új streamet a megadott tárolóobjektumban, ahol a hiba normál, elvárt állapot.

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

Paraméterek

lpStorage
A létrehozandó streamet tartalmazó OLE-tárobjektumra mutat. Nem lehet NULL.

lpszStreamName
A létrehozandó stream neve. Nem lehet NULL.

nOpenFlags
A stream megnyitásakor használható hozzáférési mód. Alapértelmezés szerint kizárólagos, olvasási/írási és létrehozási módokat használ a rendszer. Az elérhető módok teljes listáját a CFile::CFilecímű témakörben találja.

pError
Egy CFileException objektumra vagy NULL értékre mutat. Adja meg ezt a paramétert, ha a stream létrehozásával létrehozott lehetséges kivételeket szeretné figyelni.

Visszaadott érték

Nonzero, ha a stream sikeresen létrejött; egyéb esetben 0.

Megjegyzések

A fájlkivétel akkor lép fel, ha a megnyitás sikertelen, és pError nem NULL.

További információ: IStorage::CreateStream a Windows SDK-ban.

COleStreamFile::D etach

A stream leválasztása az objektumról a stream bezárása nélkül.

LPSTREAM Detach();

Visszaadott érték

Az objektumhoz társított stream (IStream) mutatója.

Megjegyzések

A streamet más módon kell bezárni, mielőtt a program leáll.

További információ: IStream a Windows SDK-ban.

COleStreamFile::GetStream

Hívja meg ezt a függvényt, hogy egy mutatót adjon vissza az aktuális streamhez.

IStream* GetStream() const;

Visszaadott érték

Mutató az aktuális streamfelületre (IStream).

COleStreamFile::OpenStream

Megnyitja a meglévő streamet.

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

Paraméterek

lpStorage
A megnyitni kívánt streamet tartalmazó OLE-tárobjektumra mutat. Nem lehet NULL.

lpszStreamName
A megnyitni kívánt stream neve. Nem lehet NULL.

nOpenFlags
A stream megnyitásakor használható hozzáférési mód. Alapértelmezés szerint kizárólagos és olvasási/írási módokat használ. Az elérhető módok teljes listáját a CFile::CFilecímű témakörben találja.

pError
Egy CFileException objektumra vagy NULL értékre mutat. Adja meg ezt a paramétert, ha figyelni szeretné a stream megnyitásával létrehozott lehetséges kivételeket.

Visszaadott érték

Nonzero, ha a stream sikeresen meg van nyitva; egyéb esetben 0.

Megjegyzések

A fájlkivétel akkor lép fel, ha a megnyitás sikertelen, és pError nem NULL.

További információ: IStorage::OpenStream a Windows SDK-ban.

Lásd még:

CFile Osztály
hierarchiadiagram