共用方式為

OleLoadPicturePath 函式 (olectl.h)

  • 發行項

建立新的圖片物件，並從資料流程的內容初始化它。 這相當於呼叫 OleCreatePictureIndirect (Null，...) 後面接著 IPersistStream：：Load。

語法

WINOLECTLAPI OleLoadPicturePath(
  [in]  LPOLESTR  szURLorPath,
  [in]  LPUNKNOWN punkCaller,
  [in]  DWORD     dwReserved,
  [in]  OLE_COLOR clrReserved,
  [in]  REFIID    riid,
  [out] LPVOID    *ppvRet
);

參數

[in] szURLorPath

您要開啟之檔案的路徑或 URL。

[in] punkCaller

指向 COM 匯總的 IUnknown 。

[in] dwReserved

保留的。

[in] clrReserved

您想要保留的色彩是透明的。

[in] riid

描述在 ppvRet 中傳回之介面指標類型的介面識別碼參考。

[out] ppvRet

接收 riid 中要求的介面指標的指標變數位址。 成功傳回時，*ppvRet 會在 Moniker 所識別之物件的儲存體上包含要求的介面指標。 如果 *ppvRet 不是Null，此函式會在介面上呼叫 IUnknown：：AddRef ;呼叫者必須負責呼叫 IUnknown：：Release。 如果發生錯誤，*ppvRet 會設定為 Null。

傳回值

此函式支援標準傳回值E_OUTOFMEMORY和E_UNEXPECTED，以及下列各項：

傳回碼 描述
S_OK
 已成功建立對話方塊。
E_FAIL
 無法載入圖片資料流程。
E_POINTER
 ppvRet中的位址為Null。
E_NOINTERFACE
 物件不支援 riid中指定的介面。

備註

資料流程必須是 BMP (點陣圖) 、JPEG、WMF (中繼檔) 、ICO (圖示) 或 GIF 格式。

需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 olectl.h
程式庫 OleAut32.lib
Dll OleAut32.dll

另請參閱

OleLoadPicture