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を返します。 その他の可能な値は次のとおりです。

リターン コード	説明
E_NOINTERFACE	オブジェクトは、riid で指定されたインターフェイスをサポートしていません。
E_POINTER	pPictDesc または lplpvObj のアドレスが無効です。 たとえば、 NULL である可能性があります。

注釈

fOwn パラメーターは、画像が含まれる図の GDI 画像ハンドルを所有するかどうかを示します。そのため、図オブジェクト自体が破棄されるときにピクチャが破棄されます。 関数は、 riid パラメーターで呼び出し元によって指定された新しいピクチャ オブジェクトへのインターフェイス ポインターを返します。 この呼び出しには QueryInterface が組み込まれています。 呼び出し元は、返されたインターフェイス ポインターを介して Release を呼び出す役割を担います。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	olectl.h
Library	OleAut32.lib
[DLL]	OleAut32.dll

こちらもご覧ください

OleLoadPicture

PICTDESC