Share via

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

ストリームから読み取る必要があるバイト数。ストリーム全体を読み取る必要がある場合は 0。

[in] fRunmode

KeepOriginalFormat プロパティの初期値の反対。 TRUE の場合、KeepOriginalFormat は FALSE に設定され、その逆も同様です。

[in] riid

ppvObj で返されるインターフェイス ポインターの型を記述するインターフェイスの識別子への参照。

[out] lplpvObj

riid で要求されたインターフェイス ポインターを受け取るポインター変数のアドレス。 正常に戻ると、*ppvObj には、モニカーによって識別されるオブジェクトのストレージに対する要求されたインターフェイス ポインターが含まれます。 *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
Library OleAut32.lib
[DLL] OleAut32.dll

関連項目

OleCreatePictureIndirect

PICTDESC