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 にはモニカーによって識別されるオブジェクトのストレージ上の要求されたインターフェイス ポインターが含まれます。 *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 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー olectl.h
Library OleAut32.lib
[DLL] OleAut32.dll

関連項目

OleLoadPicture