COleStreamFile – třída

Představuje datový proud (IStream) ve složeném souboru jako součást strukturovaného úložiště OLE.

Syntaxe

class COleStreamFile : public CFile

Členové

Veřejné konstruktory

Název	Popis
COleStreamFile::COleStreamFile	COleStreamFile Vytvoří objekt.

Veřejné metody

Název	Popis
COleStreamFile::Attach	Přidruží datový proud k objektu.
COleStreamFile::CreateMemoryStream	Vytvoří datový proud z globální paměti a přidruží ho k objektu.
COleStreamFile::CreateStream	Vytvoří datový proud a přidruží ho k objektu.
COleStreamFile::D etach	Oddružuje datový proud od objektu.
COleStreamFile::GetStream	Vrátí aktuální datový proud.
COleStreamFile::OpenStream	Bezpečně otevře datový proud a přidruží ho k objektu.

Poznámky

Objekt IStorage musí existovat před otevřením nebo vytvořením datového proudu, pokud se nejedná o datový proud paměti.

COleStreamFile objekty jsou manipulovány přesně stejně jako objekty CFile .

Další informace o manipulaci se streamy a úložišti naleznete v článku Kontejnery: Složené soubory..

Další informace naleznete v tématu IStream a IStorage v sadě Windows SDK.

Hierarchie dědičnosti

Objekt CObject

CFile

COleStreamFile

Požadavky

Hlavička: afxole.h

COleStreamFile::Attach

Přidruží zadaný datový proud OLE k objektu COleStreamFile .

void Attach(LPSTREAM lpStream);

Parametry

lpStream
Odkazuje na datový proud OLE (IStream), který má být přidružen k objektu. Nesmí mít hodnotu NULL.

Poznámky

Objekt již nesmí být přidružen k datovému proudu OLE.

Další informace naleznete v tématu IStream v sadě Windows SDK.

COleStreamFile::COleStreamFile

COleStreamFile Vytvoří objekt.

COleStreamFile(LPSTREAM lpStream = NULL);

Parametry

lpStream
Ukazatel na datový proud OLE, který má být přidružen k objektu.

Poznámky

Pokud je lpStream null, objekt není přidružen k ole stream, jinak je objekt přidružen k zadanému datovému proudu OLE.

Další informace naleznete v tématu IStream v sadě Windows SDK.

COleStreamFile::CreateMemoryStream

Bezpečně vytvoří nový datový proud z globální sdílené paměti, kde selhání je normální očekávaná podmínka.

BOOL CreateMemoryStream(CFileException* pError = NULL);

Parametry

Chyba pError
Odkazuje na objekt CFileException nebo NULL, který označuje stav dokončení operace vytvoření. Tento parametr zadejte, pokud chcete monitorovat možné výjimky vygenerované pokusem o vytvoření datového proudu.

Návratová hodnota

Nenulové, pokud je datový proud úspěšně vytvořen; jinak 0.

Poznámky

Paměť je přidělena subsystémem OLE.

Další informace naleznete v tématu CreateStreamOnHGlobal v sadě Windows SDK.

COleStreamFile::CreateStream

Bezpečně vytvoří nový datový proud v zadaném objektu úložiště, kde selhání je normální a očekávaná podmínka.

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

Parametry

lpStorage
Odkazuje na objekt úložiště OLE, který obsahuje datový proud, který se má vytvořit. Nesmí mít hodnotu NULL.

lpszStreamName
Název datového proudu, který se má vytvořit. Nesmí mít hodnotu NULL.

nOpenFlags
Režim přístupu, který se použije při otevření datového proudu. Ve výchozím nastavení se používají exkluzivní režimy čtení a zápisu a vytváření. Úplný seznam dostupných režimů najdete v tématu CFile::CFile.

Chyba pError
Odkazuje na objekt CFileException nebo NULL. Tento parametr zadejte, pokud chcete monitorovat možné výjimky vygenerované pokusem o vytvoření datového proudu.

Návratová hodnota

Nenulové, pokud je datový proud úspěšně vytvořen; jinak 0.

Poznámky

Pokud se otevření nezdaří a chyba pError není NULL, vyvolá se výjimka souboru.

Další informace naleznete v tématu IStorage::CreateStream v sadě Windows SDK.

COleStreamFile::D etach

Oddružuje datový proud od objektu bez zavření datového proudu.

LPSTREAM Detach();

Návratová hodnota

Ukazatel na datový proud (IStream), který byl přidružen k objektu.

Poznámky

Datový proud musí být uzavřen jiným způsobem před ukončením programu.

Další informace naleznete v tématu IStream v sadě Windows SDK.

COleStreamFile::GetStream

Voláním této funkce vrátíte ukazatel na aktuální datový proud.

IStream* GetStream() const;

Návratová hodnota

Ukazatel na aktuální rozhraní streamu ( IStream).

COleStreamFile::OpenStream

Otevře existující datový proud.

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

Parametry

lpStorage
Odkazuje na objekt úložiště OLE, který obsahuje datový proud, který se má otevřít. Nesmí mít hodnotu NULL.

lpszStreamName
Název datového proudu, který se má otevřít. Nesmí mít hodnotu NULL.

nOpenFlags
Režim přístupu, který se použije při otevření datového proudu. Ve výchozím nastavení se používají exkluzivní režimy čtení a zápisu. Úplný seznam dostupných režimů najdete v tématu CFile::CFile.

Chyba pError
Odkazuje na objekt CFileException nebo NULL. Tento parametr zadejte, pokud chcete monitorovat možné výjimky vygenerované pokusem o otevření datového proudu.

Návratová hodnota

Nenulové, pokud je datový proud úspěšně otevřen; jinak 0.

Poznámky

Pokud se otevření nezdaří a chyba pError není NULL, vyvolá se výjimka souboru.

Další informace naleznete v tématu IStorage::OpenStream v sadě Windows SDK.

Viz také

CFile – třída
Graf hierarchie