OleRegGetMiscStatus 関数 (ole2.h)

  • [アーティクル]

指定した CLSID でサポートされているプレゼンテーションと動作に関するその他の情報をレジストリから返します。

この関数は、OLE の既定のハンドラーの動作をエミュレートするために、カスタム DLL オブジェクト アプリケーションの開発者によって使用されます。

構文

HRESULT OleRegGetMiscStatus(
  [in]  REFCLSID clsid,
  [in]  DWORD    dwAspect,
  [out] DWORD    *pdwStatus
);

パラメーター

[in] clsid

状態情報を要求するクラスの CLSID。

[in] dwAspect

情報が要求されるクラスのプレゼンテーションの側面。 指定できる値は、 DVASPECT 列挙から取得されます。

[out] pdwStatus

状態情報を受け取る変数へのポインター。

戻り値

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

リターン コード 説明
S_OK
 状態情報が正常に返されました。
REGDB_E_CLASSNOTREG
 クラス オブジェクトに CLSID が登録されていません。
REGDB_E_READREGDB
 レジストリからの読み取り中にエラーが発生しました。
OLE_E_REGDB_KEY
 レジストリに GetMiscStatus キーがありません。

解説

オブジェクト アプリケーションは、OLE に対して、2 つの方法のいずれかでその他の状態情報を取得するように求めることができます。 1 つの方法は、 OleRegGetMiscStatus を呼び出す方法です。 もう 1 つは、 IOleObject::GetMiscStatus に対する既定のオブジェクト ハンドラーによる呼び出しに応答して、OLE_S_USEREGを返す方法です。 OLE_S_USEREGは、 OleRegGetMiscStatus を呼び出すように既定のハンドラーに指示します。 DLL オブジェクト アプリケーションはOLE_S_USEREGを返すことができないため、ジョブをオブジェクト ハンドラーに委任するのではなく 、OleRegGetMiscStatus を呼び出す必要があります。

OleRegGetMiscStatus とその兄弟関数 OleRegGetUserType、 OleRegEnumFormatEtc、 および OleRegEnumVerbs は、カスタム DLL オブジェクト アプリケーションの開発者が、レジストリからオブジェクトに関する情報を取得する際に OLE の既定のオブジェクト ハンドラーの動作をエミュレートする方法を提供します。 これらの関数を使用すると、独自の関数を記述する作業や、レジストリで直接作業する際の落とし穴を回避できます。 さらに、これらの関数を自分でコーディングしなくても、これらの関数の将来の機能強化と最適化が行われます。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー ole2.h
Library Ole32.lib
[DLL] Ole32.dll
API セット ext-ms-win-com-ole32-l1-1-3 (Windows 10 バージョン 10.0.10240 で導入)

関連項目

IOleObject::GetMiscStatus

OleRegEnumFormatEtc

OleRegEnumVerbs

OleRegGetUserType