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。 其他可能的值包括下列專案。

備註

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

需求

另請參閱

OleCreatePictureIndirect

PICTDESC