WriteFmtUserTypeStg 函数 (ole2.h)

WriteFmtUserTypeStg 函数将剪贴板格式和用户类型写入存储对象。

语法

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

参数

[in] pstg

指向要写入信息的存储对象的 IStorage 指针。

[in] cf

指定描述存储对象的本机区域结构的剪贴板格式。 格式标记包括此存储对象中流和子存储名称的策略,以及用于解释这些流中的数据的规则。

[in] lpszUserType

指向以 null 结尾的 Unicode 字符串的指针,该字符串指定对象的当前用户类型。 用户类型值本身不能为 NULL。 这是 IOleObject::GetUserType 方法返回的类型。 如果将此函数传输到对象类不存在的远程计算机,则可以在对话框中向用户显示此持久存储的用户类型。

返回值

此函数返回 HRESULT。

注解

必须在对象的 IPersistStorage::Save 方法实现中调用 WriteFmtUserTypeStg 函数。 它还必须由文档级对象调用,这些对象使用结构化存储在其保存序列中持久表示形式。

为了读取保存的信息,应用程序调用 ReadFmtUserTypeStg 函数。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 ole2.h
Library Ole32.lib
DLL Ole32.dll
API 集 ext-ms-win-com-ole32-l1-1-3 (在 Windows 10 版本 10.0.10240 中引入)

另请参阅

IPersistStorage::Save

ReadFmtUserTypeStg