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 | Öffnet einen Datenstrom sicher 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
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
Erstellt sicher einen neuen Datenstrom außerhalb des globalen freigegebenen Speichers, 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
Erstellt sicher 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.