OleCreatePictureIndirect

PICTDESC 構造体に従って初期化された新しいピクチャオブジェクトを作成する。

OleCreatePictureIndirect lpPictDesc, riid, fOwn, lplpvObj

lpPictDesc : [var] ピクチャの初期状態を含む、呼び出し元が割り当てた構造体へのポインタ。IPersistStream::Load を介してピクチャを初期化する必要がある場合、未初期化のオブジェクトを作成するために指定する構造体は NULL でも構わない。
riid : [var] lplpvObj で返すインターフェイスポインタの種類を記述するインターフェイスの識別子への参照。
fOwn : [int] TRUE の場合、ピクチャオブジェクトは破棄される時に自身のピクチャも破棄する。FALSE の場合、ピクチャの破棄は呼び出し元の責任となる。
lplpvObj : [var] riid で要求されたインターフェイスポインタを受け取るポインタ変数のアドレス。成功して戻った時、この引数は新しく作成されたオブジェクトに対する要求されたインターフェイスポインタを含む。呼び出しが成功した場合、新しいオブジェクトが不要になった時、呼び出し元はこのインターフェイスポインタを通じて Release を呼び出す責任を負う。呼び出しが失敗した場合は値が NULL に設定される。

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

解説

PICTDESC 構造体に従って初期化された新しいピクチャオブジェクトを作成する。

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

[備考]
fOwn 引数は、ピクチャがそれに含まれる GDI
ピクチャハンドルを所有するかどうかを示し、所有する場合、ピクチャオブジェクトは自身が破棄される時にピクチャも破棄する。関数は呼び出し元が
riid 引数で指定した新しいピクチャオブジェクトへのインターフェイスポインタを返す。QueryInterface
はこの呼び出しに組み込まれている。返されたインターフェイスポインタを通じて Release を呼び出すのは呼び出し元の責任である。

情報