Класс COleStreamFile

Представляет поток данных (IStream) в составном файле как часть структурированного хранения OLE.

Синтаксис

class COleStreamFile : public CFile

Участники

Открытые конструкторы

Имя	Описание
COleStreamFile::COleStreamFile	Формирует объект COleStreamFile.

Открытые методы

Имя	Описание
COleStreamFile::Attach	Связывает поток с объектом.
COleStreamFile::CreateMemoryStream	Создает поток из глобальной памяти и связывает его с объектом.
COleStreamFile::CreateStream	Создает поток и связывает его с объектом.
COleStreamFile::D etach	Отсоединяет поток от объекта.
COleStreamFile::GetStream	Возвращает текущий поток.
COleStreamFile::OpenStream	Сейф открывает поток и связывает его с объектом.

Замечания

Объект IStorage должен существовать перед открытием или созданием потока, если он не является потоком памяти.

COleStreamFile объекты обрабатываются точно так же, как объекты CFile .

Дополнительные сведения об управлении потоками и хранилищами см. в статье Контейнеры: Составные файлы..

Дополнительные сведения см. в статье IStream и I служба хранилища в пакете SDK для Windows.

Иерархия наследования

CObject

Cfile

COleStreamFile

Требования

Заголовок: afxole.h

COleStreamFile::Attach

Связывает предоставленный поток OLE с COleStreamFile объектом.

void Attach(LPSTREAM lpStream);

Параметры

lpStream
Указывает на поток OLE (IStream), связанный с объектом. Не может быть NULL.

Замечания

Объект не должен быть связан с потоком OLE.

Дополнительные сведения см. в разделе IStream в пакете SDK для Windows.

COleStreamFile::COleStreamFile

Создает объект COleStreamFile.

COleStreamFile(LPSTREAM lpStream = NULL);

Параметры

lpStream
Указатель на поток OLE, связанный с объектом.

Замечания

Если значение lpStream равно NULL, объект не связан с потоком OLE, в противном случае объект связан с предоставленным потоком OLE.

Дополнительные сведения см. в разделе IStream в пакете SDK для Windows.

COleStreamFile::CreateMemoryStream

Сейф создает новый поток из глобальной общей памяти, в которой сбой является нормальным, ожидаемым условием.

BOOL CreateMemoryStream(CFileException* pError = NULL);

Параметры

pError
Указывает на объект CFileException или NULL, указывающий состояние завершения операции создания. Укажите этот параметр, если вы хотите отслеживать возможные исключения, созданные путем попытки создать поток.

Возвращаемое значение

Ненулевое значение, если поток создан успешно; в противном случае — 0.

Замечания

Память выделяется подсистемой OLE.

Дополнительные сведения см. в статье CreateStreamOnHGlobal в пакете SDK для Windows.

COleStreamFile::CreateStream

Сейф создает новый поток в предоставленном объекте хранилища, где сбой является нормальным, ожидаемым условием.

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

Параметры

lp служба хранилища
Указывает на объект хранилища OLE, содержащий созданный поток. Не может быть NULL.

lpszStreamName
Имя создаваемого потока. Не может быть NULL.

nOpenFlags
Режим доступа, используемый при открытии потока. По умолчанию используются монопольные режимы чтения и записи и создания. Полный список доступных режимов см. в разделе CFile::CFile.

pError
Указывает на объект CFileException или NULL. Укажите этот параметр, если вы хотите отслеживать возможные исключения, созданные путем попытки создать поток.

Возвращаемое значение

Ненулевое значение, если поток создан успешно; в противном случае — 0.

Замечания

Исключение файла возникает, если открытие завершается ошибкой, и pError не имеет значения NULL.

Дополнительные сведения см. в статье "I служба хранилища::CreateStream" в пакете SDK для Windows.

COleStreamFile::D etach

Отсоединяет поток от объекта, не закрывая поток.

LPSTREAM Detach();

Возвращаемое значение

Указатель на поток (IStream), связанный с объектом.

Замечания

Перед завершением программы поток должен быть закрыт в другом режиме.

Дополнительные сведения см. в разделе IStream в пакете SDK для Windows.

COleStreamFile::GetStream

Вызовите эту функцию, чтобы вернуть указатель на текущий поток.

IStream* GetStream() const;

Возвращаемое значение

Указатель на текущий интерфейс потока ( IStream).

COleStreamFile::OpenStream

Открывает существующий поток.

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

Параметры

lp служба хранилища
Указывает на объект хранилища OLE, содержащий поток, который должен быть открыт. Не может быть NULL.

lpszStreamName
Имя открываемого потока. Не может быть NULL.

nOpenFlags
Режим доступа, используемый при открытии потока. По умолчанию используются монопольные и режимы чтения и записи. Полный список доступных режимов см. в разделе CFile::CFile.

pError
Указывает на объект CFileException или NULL. Укажите этот параметр, если вы хотите отслеживать возможные исключения, созданные путем попытки открыть поток.

Возвращаемое значение

Ненулевое значение, если поток открыт успешно; в противном случае — 0.

Замечания

Исключение файла возникает, если открытие завершается ошибкой, и pError не имеет значения NULL.

Дополнительные сведения см. в статье I служба хранилища::OpenStream в пакете SDK для Windows.

См. также

Класс CFile
Диаграмма иерархии