OleLoadFromStream 函式 (ole2.h)

從數據流載入物件。

語法

HRESULT OleLoadFromStream(
  [in]  LPSTREAM pStm,
  [in]  REFIID   iidInterface,
  [out] LPVOID   *ppvObj
);

[in] pStm

要從其中載入物件之數據流上的 IStream 介面指標。

[in] iidInterface

介面識別碼 (IID) 呼叫端想要在載入物件之後用來與物件通訊。

[out] ppvObj

接收 riid 中要求的介面指標的指標變數位址。成功傳回時，*ppvObj 會在新載入的物件上包含要求的介面指標。

此函式會在成功時傳回S_OK。其他可能的值包括下列專案。

傳回碼	Description
E_OUTOFMEMORY	作業的記憶體不足。
E_NOINTERFACE	物件不支援指定的介面。

此函式也可以傳回 ReadClassStm 和 CoCreateInstance 函式所傳回的任何錯誤值，以及 IPersistStream：：Load 方法。

重要

安全性注意事項：使用不受信任的數據呼叫此方法是安全性風險。呼叫此方法時，請一律使用信任的資料。

此函式可用來載入支援 IPersistStream 介面的物件。物件的 CLSID 必須緊接在數據流中的對象數據之前，該數據流是由隨附函式 OleSaveToStream (或它包裝的作業所完成，該主題所述) 。

如果數據流的 CLSID 是 CLSID_NULL，ppvObj 參數會設定為 NULL。