Функция 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 |