ReadFmtUserTypeStg 函式 (ole2.h)

ReadFmtUserTypeStg 函式會傳回先前與 WriteFmtUserTypeStg 函式一起儲存的剪貼簿格式和用戶類型。

語法

HRESULT ReadFmtUserTypeStg(
  [in]  LPSTORAGE  pstg,
  [out] CLIPFORMAT *pcf,
  [out] LPOLESTR   *lplpszUserType
);

[in] pstg

要讀取資訊的記憶體物件上 IStorage 介面的指標。

[out] pcf

要傳回剪貼簿格式的指標。它可以是 NULL，表示格式對呼叫端沒有興趣。

[out] lplpszUserType

接收 Null 終止 Unicode 使用者類型字串指標的 LPWSTR 指標變數位址。呼叫端可以指定此參數的 NULL ，這表示用戶類型不感興趣。此函式會配置字串的記憶體。呼叫端負責使用 CoTaskMemFree 釋放記憶體。

除了下列專案之外，此函式還支援標準傳回值E_FAIL、E_INVALIDARG和E_OUTOFMEMORY：

此函式也會傳回 ISequentialStream：：Read 方法傳回的任何錯誤值。

ReadFmtUserTypeStg 會從指定的儲存物件傳回剪貼簿格式和使用者類型字串。呼叫 ReadFmtUserTypeStg 函式之前，必須先呼叫 WriteClassStg 函式。