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

Статья
03/05/2024

Сериализует пакет, представленный объектом пакета.

Синтаксис

HRESULT WritePackageToStream(
  [in] IOpcPackage     *package,
  [in] OPC_WRITE_FLAGS flags,
  [in] IStream         *stream
);

Параметры

[in] package

Указатель на интерфейс IOpcPackage объекта пакета, содержащего данные для сериализации.

[in] flags

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

[in] stream

Указатель на интерфейс IStream потока, в котором будут записываться данные объекта пакета.

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_INVALIDARG	Значение, передаваемое в параметре flags , не является допустимым значением перечисления OPC_WRITE_FLAGS.
E_NOTIMPL	Этот метод не реализован для данной версии Windows.
E_POINTER	По крайней мере один из параметров потока и пакета имеет значение NULL.
Ошибка интерфейса IStream	Код ошибки HRESULT из интерфейса IStream .
Ошибка потребления пакета	Код ошибки HRESULT из группы ошибок потребления пакетов.
Ошибка URI части	Код ошибки HRESULT из группы ошибок URI части.

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

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

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

Этот метод не поддерживается в версиях Windows, предшествующих Windows 7. Дополнительные сведения см. в разделах начало работы с ПОМОЩЬЮ API упаковки и Обновление платформы для Windows Vista.

Потокобезопасность

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	msopc.h