Функция GetConvertStg (coml2api.h)

  • Статья

Функция GetConvertStg возвращает текущее значение бита преобразования для указанного объекта хранения.

Синтаксис

HRESULT GetConvertStg(
  [in] LPSTORAGE pStg
);

Параметры

[in] pStg

Указатель IStorage на объект хранилища, из которого извлекается бит преобразования.

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

Ошибки IStorage::OpenStream, IStorage::OpenStorage и ISequentialStream::Read .

Комментарии

Функция GetConvertStg вызывается серверами объектов, которые поддерживают преобразование объекта из одного формата в другой. Сервер должен иметь возможность считывать объект хранилища в формате предыдущего идентификатора класса (CLSID) и записывать объект в формате нового идентификатора CLSID для поддержки преобразования объекта. Например, электронную таблицу, созданную одним приложением, можно преобразовать в формат, используемый другим приложением.

Бит преобразования задается вызовом функции SetConvertStg . Контейнерное приложение может вызывать эту функцию по запросу конечного пользователя или программа установки может вызывать ее при установке новой версии приложения. Пользователь запрашивает преобразование объекта с помощью диалогового окна Преобразование в. При преобразовании объекта новый ИДЕНТИФИКАТОР CLSID назначается объекту без возможности восстановления, поэтому объект впоследствии связывается с новым ИДЕНТИФИКАТОРом CLSID.

Затем при активации объекта сервер вызывает функцию GetConvertStg для получения значения бита преобразования из объекта хранилища. Если задан бит, идентификатор CLSID объекта был изменен, и сервер должен прочитать старый формат и записать новый формат для объекта хранилища.

После получения битового значения приложение объекта должно очистить бит преобразования, вызвав функцию SetConvertStg с параметром fConvert , равным FALSE.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа Windows
Header coml2api.h (включая Ole2.h)
Библиотека Ole32.lib
DLL Ole32.dll

См. также раздел

SetConvertStg