COleStreamFile-Klasse

Stellt einen Datenstream (IStream) in einer Verbunddatei als Teil einer strukturierten Speicherung (OLE Structured Storage) dar.

Syntax

class COleStreamFile : public CFile

Member

Öffentliche Konstruktoren

Name	Beschreibung
COleStreamFile::COleStreamFile	Erstellt ein COleStreamFile-Objekt.

Öffentliche Methoden

Name	Beschreibung
COleStreamFile::Attach	Ordnet einen Datenstrom dem Objekt zu.
COleStreamFile::CreateMemoryStream	Erstellt einen Datenstrom aus dem globalen Speicher und ordnet ihn dem Objekt zu.
COleStreamFile::CreateStream	Erstellt einen Datenstrom und ordnet ihn dem Objekt zu.
COleStreamFile::D etach	Entfernt die Zuordnung des Datenstroms vom Objekt.
COleStreamFile::GetStream	Gibt den aktuellen Datenstrom zurück.
COleStreamFile::OpenStream	Tresor öffnet einen Datenstrom und ordnet ihn dem Objekt zu.

Hinweise

Ein IStorage Objekt muss vorhanden sein, bevor der Datenstrom geöffnet oder erstellt werden kann, es sei denn, es handelt sich um einen Speicherdatenstrom.

COleStreamFile Objekte werden genau wie CFile-Objekte bearbeitet.

Weitere Informationen zum Bearbeiten von Datenströmen und Speicher finden Sie im Artikel "Container: Verbunddateien".

Weitere Informationen finden Sie unter IStream und IStorage im Windows SDK.

Vererbungshierarchie

CObject

Cfile

COleStreamFile

Anforderungen

Kopfzeile: afxole.h

COleStreamFile::Attach

Ordnet den angegebenen OLE-Datenstrom dem Objekt zu COleStreamFile .

void Attach(LPSTREAM lpStream);

Parameter

lpStream
Verweist auf den OLE-Datenstrom (IStream), der dem Objekt zugeordnet werden soll. Lässt keine NULL-Werte zu.

Hinweise

Das Objekt darf nicht bereits einem OLE-Datenstrom zugeordnet sein.

Weitere Informationen finden Sie unter IStream im Windows SDK.

COleStreamFile::COleStreamFile

Erstellt ein COleStreamFile-Objekt.

COleStreamFile(LPSTREAM lpStream = NULL);

Parameter

lpStream
Zeiger auf den OLE-Datenstrom, der dem Objekt zugeordnet werden soll.

Hinweise

Wenn lpStream NULL ist, ist das Objekt keinem OLE-Datenstrom zugeordnet, andernfalls wird das Objekt dem bereitgestellten OLE-Datenstrom zugeordnet.

Weitere Informationen finden Sie unter IStream im Windows SDK.

COleStreamFile::CreateMemoryStream

Tresor erstellt einen neuen Datenstrom aus dem globalen freigegebenen Speicher, in dem ein Fehler eine normale, erwartete Bedingung ist.

BOOL CreateMemoryStream(CFileException* pError = NULL);

Parameter

pError
Verweist auf ein CFileException -Objekt oder NULL, das den Abschlussstatus des Erstellungsvorgangs angibt. Geben Sie diesen Parameter an, wenn Sie mögliche Ausnahmen überwachen möchten, die generiert werden, indem Sie versuchen, den Datenstrom zu erstellen.

Rückgabewert

Nonzero, wenn der Datenstrom erfolgreich erstellt wird; andernfalls 0.

Hinweise

Der Speicher wird vom OLE-Subsystem zugewiesen.

Weitere Informationen finden Sie unter CreateStreamOnHGlobal im Windows SDK.

COleStreamFile::CreateStream

Tresor erstellt einen neuen Datenstrom im bereitgestellten Speicherobjekt, bei dem ein Fehler eine normale, erwartete Bedingung ist.

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

Parameter

lpStorage
Verweist auf das OLE-Speicherobjekt, das den zu erstellenden Datenstrom enthält. Lässt keine NULL-Werte zu.

lpszStreamName
Name des zu erstellenden Datenstroms. Lässt keine NULL-Werte zu.

nOpenFlags
Access-Modus, der beim Öffnen des Datenstroms verwendet werden soll. Exklusive Modi, Lese-/Schreibzugriff und Erstellungsmodi werden standardmäßig verwendet. Eine vollständige Liste der verfügbaren Modi finden Sie unter "CFile::CFile".

pError
Verweist auf ein CFileException -Objekt oder NULL. Geben Sie diesen Parameter an, wenn Sie mögliche Ausnahmen überwachen möchten, die generiert werden, indem Sie versuchen, den Datenstrom zu erstellen.

Rückgabewert

Nonzero, wenn der Datenstrom erfolgreich erstellt wird; andernfalls 0.

Hinweise

Eine Datei exception will be thrown if the open fails and pError is not NULL.

Weitere Informationen finden Sie unter "IStorage::CreateStream " im Windows SDK.

COleStreamFile::D etach

Entfernt die Zuordnung des Datenstroms vom Objekt, ohne den Datenstrom zu schließen.

LPSTREAM Detach();

Rückgabewert

Ein Zeiger auf den Datenstrom (IStream), der dem Objekt zugeordnet war.

Hinweise

Der Datenstrom muss auf andere Weise geschlossen werden, bevor das Programm beendet wird.

Weitere Informationen finden Sie unter IStream im Windows SDK.

COleStreamFile::GetStream

Rufen Sie diese Funktion auf, um einen Zeiger auf den aktuellen Datenstrom zurückzugeben.

IStream* GetStream() const;

Rückgabewert

Ein Zeiger auf die aktuelle Datenstromschnittstelle ( IStream).

COleStreamFile::OpenStream

Öffnet einen vorhandenen Datenstrom.

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

Parameter

lpStorage
Verweist auf das OLE-Speicherobjekt, das den zu öffnenden Datenstrom enthält. Lässt keine NULL-Werte zu.

lpszStreamName
Name des zu öffnenden Datenstroms. Lässt keine NULL-Werte zu.

nOpenFlags
Access-Modus, der beim Öffnen des Datenstroms verwendet werden soll. Exklusive Und Lese-/Schreibmodi werden standardmäßig verwendet. Die vollständige Liste der verfügbaren Modi finden Sie unter "CFile::CFile".

pError
Verweist auf ein CFileException -Objekt oder NULL. Geben Sie diesen Parameter an, wenn Sie mögliche Ausnahmen überwachen möchten, die generiert werden, indem Sie versuchen, den Datenstrom zu öffnen.

Rückgabewert

Nonzero, wenn der Datenstrom erfolgreich geöffnet wird; andernfalls 0.

Hinweise

Eine Datei exception will be thrown if the open fails and pError is not NULL.

Weitere Informationen finden Sie unter "IStorage::OpenStream " im Windows SDK.

Siehe auch

CFile-Klasse
Hierarchiediagramm