共用方式為

OleCreatePictureIndirect 函式 (olectl.h)

  • 發行項

建立根據 PICTDESC 結構初始化的新圖片物件。

語法

WINOLECTLAPI OleCreatePictureIndirect(
  [in]  LPPICTDESC lpPictDesc,
  [in]  REFIID     riid,
  [in]  BOOL       fOwn,
  [out] LPVOID     *lplpvObj
);

參數

[in] lpPictDesc

呼叫端配置結構的指標，其中包含圖片的初始狀態。 在圖片需要透過 IPersistStream：：Load 初始化時，指定的結構可以是 NULL 來建立未初始化的物件。

[in] riid

描述在 lplpvObj 中傳回之介面指標類型的介面標識元參考。

[in] fOwn

如果 為 TRUE，則圖片物件會在終結對象時終結其圖片。 如果為 FALSE，則呼叫端負責終結圖片。

[out] lplpvObj

接收 riid 中所要求介面指標的指標變數位址。 成功傳回時，此參數會在新建立的物件上包含要求的介面指標。 如果呼叫成功，當不再需要新物件時，呼叫端會負責透過這個介面指標呼叫 Release 。 如果呼叫失敗，此值會設定為 NULL。

傳回值

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

傳回碼 Description
E_NOINTERFACE
 物件不支援 riid 中指定的介面。
E_POINTER
 pPictDesc 或 lplpvObj 中的地址無效。 例如，它可能是 NULL。

備註

fOwn 參數會指出圖片是否要擁有其包含之圖片的 GDI 圖片控點，讓圖片對象在終結物件本身時終結其圖片。 函式會傳回 riid 參數中呼叫端所指定之新圖片對象的介面指標。 QueryInterface 內建於此呼叫中。 呼叫端負責透過傳回的介面指標呼叫 Release 。

規格需求

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

另請參閱

OleLoadPicture

PICTDESC