CoGetObject 関数 (objbase.h)

  • [アーティクル]

表示名を という名前のオブジェクトを識別するモニカーに変換し、モニカーによって識別されるオブジェクトにバインドします。

構文

HRESULT CoGetObject(
  [in]           LPCWSTR   pszName,
  [in, optional] BIND_OPTS *pBindOptions,
  [in]           REFIID    riid,
  [out]          void      **ppv
);

パラメーター

[in] pszName

作成するオブジェクトの表示名。

[in, optional] pBindOptions

実際のオブジェクトを作成するモニカーを作成するために使用されるバインド オプション。 詳細については、「 BIND_OPTS」を参照してください。 このパラメーターは、NULL でもかまいません。

[in] riid

作成するオブジェクトに実装されるインターフェイスの識別子への参照。

[out] ppv

作成されるオブジェクトの riid によって指定されたインターフェイスへのポインターのアドレス。

戻り値

この関数は、E_FAIL、E_OUTOFMEMORY、E_UNEXPECTEDの標準戻り値と、次の値を返すことができます。

リターン コード 説明
S_OK
 オブジェクトが正常に作成されました。
MK_E_SYNTAX
 pszName パラメーターが正しい形式の表示名ではありません。
MK_E_NOOBJECT
 このモニカーによって識別されるオブジェクト、またはこのモニカーが一部である複合モニカーによって識別されたオブジェクトが見つかりませんでした。
MK_E_EXCEEDEDDEADLINE
 pBindOptions で渡されたBIND_OPTS構造体で指定された制限時間内にバインド操作を完了できませんでした。
MK_E_CONNECTMANUALLY
 バインド操作には、エンド ユーザーからの支援が必要です。 この値を返す最も一般的な理由は、パスワードが必要であるか、フロッピーをマウントする必要があるということです。
MK_E_INTERMEDIATEINTERFACENOTSUPPORTED
 中間オブジェクトが見つかりましたが、バインド操作を完了するために必要なインターフェイスはサポートされていません。 たとえば、項目モニカーは、コンテナーが IOleItemContainer インターフェイスをサポートしていない場合、この値を返します。

注釈

CoGetObject は 、COM ライブラリ関数 CreateBindCtx、 MkParseDisplayName、および IMoniker::BindToObject の呼び出しをカプセル化します。

要件

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

こちらもご覧ください

BIND_OPTS