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屬性的初始值相反。 如果 為 TRUE, KeepOriginalFormat 會設定為 FALSE ,反之亦然。
[in] riid
介面識別碼的參考,描述 ppvObj中傳回的介面指標類型。
[out] lplpvObj
接收 riid 中所要求介面指標的指標變數位址。 成功傳回時,*ppvObj 會在 Moniker 所識別之物件的儲存區上包含要求的介面指標。 如果 *ppvObj 不是Null,此函式會在介面上呼叫 IUnknown::AddRef ;呼叫者必須負責呼叫 IUnknown::Release。 如果發生錯誤,*ppvObj 會設定為 Null。
傳回值
此函式會在成功時傳回S_OK。 其他可能的值包括下列專案。
傳回碼 | 描述 |
---|---|
|
物件不支援指定的介面。 |
|
資料流程無效。 例如,它可能是 Null。 |
備註
資料流程必須是 BMP (點陣圖) 、WMF (中繼檔) ,或 ICO (圖示) 格式。 使用OleLoadPicture建立的圖片物件一律擁有其內部資源的擁有權, (fOwn==TRUE是隱含的) 。
需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | olectl.h |
程式庫 | OleAut32.lib |
Dll | OleAut32.dll |