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。

備註

WriteFmtUserTypeStg 函式必須在物件的 IPersistStorage::Save 方法實作中呼叫。 它也必須由檔層級物件呼叫,這些物件會在其儲存順序中使用結構化記憶體的持續性表示法。

若要讀取儲存的資訊,應用程式會呼叫 ReadFmtUserTypeStg 函式。

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 ole2.h
程式庫 Ole32.lib
Dll Ole32.dll
API 集合 ext-ms-win-com-ole32-l1-1-3 (Windows 10 10.0.10240 版)

另請參閱

IPersistStorage::Save

ReadFmtUserTypeStg