Метод IOpcFactory::CreateStreamOnFile (msopc.h)

Статья
11/20/2024

Создает поток по файлу. Этот метод представляет собой упрощенную оболочку для вызова функции CreateFile. параметры CreateFile, не предоставляемые этим методом, используют значения по умолчанию. Дополнительные сведения см. в разделе CreateFile.

Синтаксис

HRESULT CreateStreamOnFile(
  [in]          LPCWSTR               filename,
  [in]          OPC_STREAM_IO_MODE    ioMode,
  [in]          LPSECURITY_ATTRIBUTES securityAttributes,
  [in]          DWORD                 dwFlagsAndAttributes,
  [out, retval] IStream               **stream
);

Параметры

[in] filename

Имя файла, над которым создается поток.

[in] ioMode

Значение, описывающее состояние чтения и записи создаваемого потока.

[in] securityAttributes

Сведения о структуре SECURITY_ATTRIBUTES в этом параметре см. в функции CreateFile.

[in] dwFlagsAndAttributes

Параметры и атрибуты файла. Для большинства файлов можно использовать FILE_ATTRIBUTE_NORMAL.

Дополнительные сведения об этом параметре см. в разделе CreateFile.

[out, retval] stream

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

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

Метод возвращает HRESULT. Возможные значения включают, но не ограничиваются ими в следующей таблице.

Возвращаемый код	Описание
S_OK	Метод выполнен успешно.
E_INVALIDARG	Значение, переданное в параметре ioMode, не является допустимым значением перечисления OPC_STREAM_IO_MODE.
E_POINTER	По крайней мере один из имени файла и параметров потока является NULL.
ошибка функции CreateFile	Код ошибки HRESULT из функции CreateFile.

Замечания

Не используйте поток для сериализации данных пакета, если тот же поток используется для десериализации пакета, так как попытка может привести к неопределенному поведению.

Сведения об использовании этого метода при загрузке или сохранении пакета см. в разделе Загрузка пакета или сохранение задачи программирования пакета.

поддержка в предыдущих версиях Windows

Поведение и производительность этого метода одинакова во всех поддерживаемых версиях Windows. Дополнительные сведения см. в разделе начало работы сAPI упаковки и обновление платформы для Windows Vista.

Безопасность потоков

Объекты упаковки не являются потокобезопасными.

Дополнительные сведения см. в приступая к работе сAPI упаковки.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и обновление платформы для Windows Server 2008 [только классические приложения]
целевая платформа	Виндоус
заголовка	msopc.h