共用方式為


OleLoadPicture 函式 (olectl.h)

建立新的圖片物件,並從資料流程的內容初始化它。 這相當於使用Null作為第一個參數呼叫OleCreatePictureIndirect,後面接著呼叫 IPersistStream::Load

語法

WINOLECTLAPI OleLoadPicture(
  [in]  LPSTREAM lpstream,
  [in]  LONG     lSize,
  [in]  BOOL     fRunmode,
  [in]  REFIID   riid,
  [out] LPVOID   *lplpvObj
);

參數

[in] lpstream

包含圖片資料的資料流程指標。

[in] lSize

應該從資料流程讀取的位元組數目,如果應該讀取整個資料流程,則為零。

[in] fRunmode

與 KeepOriginalFormat屬性的初始值相反。 如果 為 TRUEKeepOriginalFormat 會設定為 FALSE ,反之亦然。

[in] riid

介面識別碼的參考,描述 ppvObj中傳回的介面指標類型。

[out] lplpvObj

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

傳回值

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

傳回碼 描述
E_NOINTERFACE
物件不支援指定的介面。
E_POINTER
資料流程無效。 例如,它可能是 Null

備註

資料流程必須是 BMP (點陣圖) 、WMF (中繼檔) ,或 ICO (圖示) 格式。 使用OleLoadPicture建立的圖片物件一律擁有其內部資源的擁有權, (fOwn==TRUE是隱含的) 。

需求

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

另請參閱

OleCreatePictureIndirect

PICTDESC