Функция WriteFmtUserTypeStg (ole2.h)

  • Статья

Функция WriteFmtUserTypeStg записывает формат буфера обмена и тип пользователя в объект хранилища.

Синтаксис

HRESULT WriteFmtUserTypeStg(
  [in] LPSTORAGE  pstg,
  [in] CLIPFORMAT cf,
  [in] LPOLESTR   lpszUserType
);

Параметры

[in] pstg

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

[in] cf

Задает формат буфера обмена, описывающий структуру собственной области объекта хранилища. Тег format включает политику для имен потоков и дочерних журналов в этом объекте хранилища, а также правила интерпретации данных в этих потоках.

[in] lpszUserType

Указатель на строку Юникода, завершающуюся null, которая указывает текущий тип пользователя объекта. Само значение типа пользователя не может иметь значение NULL. Это тип, возвращаемый методом IOleObject::GetUserType . Если эта функция переносится на удаленный компьютер, где класс объекта не существует, этот постоянно сохраненный тип пользователя может отображаться пользователю в диалоговых окнах.

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

Эта функция возвращает HRESULT.

Комментарии

Функция WriteFmtUserTypeStg должна вызываться в реализации объекта метода IPersistStorage::Save . Он также должен вызываться объектами уровня документа, которые используют структурированное хранилище для постоянного представления в своей последовательности сохранения.

Для чтения сохраненных сведений приложения вызывают функцию ReadFmtUserTypeStg .

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header ole2.h
Библиотека Ole32.lib
DLL Ole32.dll
Набор API ext-ms-win-com-ole32-l1-1-3 (представлен в Windows 10 версии 10.0.10240)

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

IPersistStorage::Save

ReadFmtUserTypeStg