OleLoadPictureEx

新しいピクチャオブジェクトを作成し、ストリームの内容から初期化する。これは、OleCreatePictureIndirect を最初の引数として NULL を指定して呼び出した後に IPersistStream::Load を呼び出すのと同等である。(OleLoadPictureEx)

OleLoadPictureEx lpstream, lSize, fRunmode, riid, xSizeDesired, ySizeDesired, dwFlags, lplpvObj

lpstream : [var] ピクチャのデータを含むストリームへのポインタ。
lSize : [int] ストリームから読み取るバイト数。ストリーム全体を読み取る場合は 0。
fRunmode : [int] KeepOriginalFormat プロパティの初期値の反対。TRUE の場合、KeepOriginalFormat は FALSE に設定され、その逆も同様。
riid : [var] ppvObj で返すインターフェイスポインタの種類を記述するインターフェイスの識別子への参照。
xSizeDesired : [int] アイコンまたはカーソルの希望幅。有効な値は 16、32、48。両方のサイズ引数に LP_DEFAULT を渡すとシステム既定のサイズを使用する。
ySizeDesired : [int] アイコンまたはカーソルの希望高さ。有効な値は 16、32、48。両方のサイズ引数に LP_DEFAULT を渡すとシステム既定のサイズを使用する。
dwFlags : [int] アイコンまたはカーソルの希望色深度。値は LP_MONOCHROME (モノクロ)、LP_VGACOLOR (16 色)、LP_COLOR (256 色)、または LP_DEFAULT (現在の表示に最適な深度を選択)。
lplpvObj : [var] riid で要求されたインターフェイスポインタを受け取るポインタ変数のアドレス。成功して戻った時、*ppvObj はモニカで識別されるオブジェクトのストレージ上で要求されたインターフェイスポインタを含む。*ppvObj が NULL でない場合、この関数はインターフェイスに対して IUnknown::AddRef を呼び出す。IUnknown::Release を呼び出すのは呼び出し元の責任である。エラーが発生した場合、*ppvObj は NULL に設定される。

(プラグイン / モジュール : oleaut32.dll)

解説

新しいピクチャオブジェクトを作成し、ストリームの内容から初期化する。これは、OleCreatePictureIndirect
を最初の引数として NULL を指定して呼び出した後に IPersistStream::Load
を呼び出すのと同等である。(OleLoadPictureEx)

[戻り値]
成功時、この関数は S_OK を返す。その他の可能な値は次のとおりである。
（以下省略）

[備考]
ストリームは BMP (ビットマップ)、WMF (メタファイル)、または ICO (アイコン)
形式でなければならない。OleLoadPictureEx を使用して作成されたピクチャオブジェクトは、常に内部リソースの所有権を持つ
(fOwn==TRUE が暗黙に設定される)。アイコンまたはカーソルサイズの指定を可能にすることに加えて、OleLoadPictureEx
はカラーカーソルのロードもサポートする。

情報