Win32 API 日本語リファレンス
ホーム › System.Com › IGlobalOptions

IGlobalOptions

COM
📘 Microsoft Learn (日本語) · English
IID0000015b-0000-0000-c000-000000000046継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IGlobalOptions (objidlbase.h) インターフェースは、Component Object Model (COM) ランタイムのグローバルプロパティを設定および照会します。

解説(Remarks)

COM ランタイムの以下のグローバルプロパティを、このインターフェースで設定および照会できます。

プロパティ 値
COMGLB_APPID プロセスの AppID です。 Windows XP でサポートされる唯一のプロパティです。
COMGLB_EXCEPTION_HANDLING COMGLB_EXCEPTION_HANDLING プロパティに指定可能な値は次のとおりです。
  • COMGLB_EXCEPTION_HANDLE: 既定の動作です。この設定により、COM ランタイムが致命的な例外を処理します。
  • COMGLB_EXCEPTION_DONOT_HANDLE: COM ランタイムが致命的な例外を処理しないようにします。
  • COMGLB_EXCEPTION_DONOT_HANDLE_FATAL: COMGLB_EXCEPTION_DONOT_HANDLE の別名です。Windows 7 以降でサポートされます。
  • COMGLB_EXCEPTION_DONOT_HANDLE_ANY: 設定した場合、COM メソッド内で致命的な例外が発生すると、COM ランタイムはその例外を処理しません。

    設定した場合、COM メソッド内で致命的でない例外が発生すると、COM ランタイムは Windows エラー報告 (WER) ダンプを作成してプロセスを終了します。 Windows 7 以降でサポートされます。

既定では、COM ランタイムはメソッド呼び出し中に発生した致命的な例外を処理し、クライアントに RPC_E_SERVERFAULT エラーコードを返します。アプリケーションはこの動作を無効化することで、例外を WER に伝播させることができ、WER はアプリケーションのプロセスダンプを作成してアプリケーションを終了します。これにより、データ破損の可能性を防ぎ、アプリケーションベンダーがダンプをデバッグできるようになります。
注意 COM ランタイムの例外処理を無効化しても、プロセス内に例外を処理する別のアプリケーションレベルの例外ハンドラーが存在する場合、例外が WER に伝播しないことがあります。
新しいアプリケーションでは、COMGLB_EXCEPTION_HANDLING プロパティを COMGLB_EXCEPTION_DONOT_HANDLE_ANY に設定することを推奨します。
COMGLB_RPC_THREADPOOL_SETTING Set メソッドにおける COMGLB_RPC_THREADPOOL_SETTING プロパティに指定可能な値は次のとおりです。 Query メソッドにおける COMGLB_RPC_THREADPOOL_SETTING プロパティに指定可能な値は次のとおりです。 Windows 7 では、RPC は既定でシステムスレッドプールを使用します。システムスレッドプールはプロセス内の複数のコンポーネントで共有されるため、あるコンポーネントによってスレッドプールの状態が破損すると、COM および RPC の操作が正しく動作しないことがあります。

COMGLB_RPC_THREADPOOL_SETTING プロパティを使用して、RPC スレッドプールの動作を変更できます。既定の動作を変更すると RPC が追加のスレッドを使用するため、パフォーマンスの低下を招きます。したがって、この設定を変更する際は注意が必要です。この設定はアプリケーションの互換性を確保する目的でのみ変更することを推奨します。

注意 このプロパティは、プロセス内で COM が初期化された直後に設定する必要があります。COM が RPC チャネルを初期化する操作 (たとえばオブジェクト参照のマーシャリングやアンマーシャリング) を実行した後にこのプロパティを設定すると、Set メソッドは失敗します。
注意 このプロパティは、Windows 7 以降のバージョンの Windows でのみサポートされます。
COMGLB_RO_SETTINGS COMGLB_RO_SETTINGS プロパティに指定可能な値は次のとおりです。
  • COMGLB_FAST_RUNDOWN: 現在のプロセス内のスタブが高速スタブランダウン動作の対象となることを示します。これは、通常のクリーンアップタイムアウトの満了を待つのではなく、クライアントプロセスの終了時にスタブがランダウンされることを意味します。
  • COMGLB_STA_MODALLOOP_REMOVE_TOUCH_MESSAGES: STA モーダルループにおいて、メッセージキューからタッチメッセージを削除します。
  • COMGLB_STA_MODALLOOP_SHARED_QUEUE_REMOVE_INPUT_MESSAGES: スレッドのメッセージキューがアタッチされている場合、STA モーダルループで入力メッセージが削除されます。
  • COMGLB_STA_MODALLOOP_SHARED_QUEUE_DONOT_REMOVE_INPUT_MESSAGES: スレッドのメッセージキューがアタッチされている場合、STA モーダルループで入力メッセージが削除されません。
  • COMGLB_STA_MODALLOOP_SHARED_QUEUE_REORDER_POINTER_MESSAGES: スレッドのメッセージキューがアタッチされている場合、STA モーダルループでポインター入力メッセージは削除されませんが、アタッチされたキューに起因するデッドロックを回避するために一時的にマスクされます。
  • COMGLB_RESERVED1: 将来の使用のために予約されています。
  • COMGLB_RESERVED2: 将来の使用のために予約されています。
  • COMGLB_RESERVED3: 将来の使用のために予約されています。
注意 このプロパティは、Windows 8 以降のバージョンの Windows でのみサポートされます。
COMGLB_UNMARSHALING_POLICY COMGLB_UNMARSHALING_POLICY プロパティに指定可能な値は次のとおりです。
  • COMGLB_UNMARSHALING_POLICY_NORMAL: アンマーシャリングの動作は Windows 8 より前のバージョンと同じです。このフラグが CoInitializeSecurity で設定されている場合、EOAC_NO_CUSTOM_MARSHAL の制約が適用されます。それ以外の場合、制約はありません。これは、アプリコンテナー内にないプロセスの既定値です。
  • COMGLB_UNMARSHALING_POLICY_STRONG: アンマーシャリングは、システムが信頼する堅牢化されたアンマーシャラーのリスト、および CoAllowUnmarshalerCLSID 関数によってプロセス単位で許可されたアンマーシャラーのみを許可します。これは、アプリコンテナー内のプロセスの既定値です。
  • COMGLB_UNMARSHALING_POLICY_HYBRID: アプリコンテナーを送信元とするデータのアンマーシャリングは、システムが信頼する堅牢化されたアンマーシャラーのリスト、および CoAllowUnmarshalerCLSID 関数によってプロセス単位で許可されたアンマーシャラーのみを許可します。送信元がアプリコンテナーでないデータのアンマーシャリング動作は、以前のバージョンから変更されません。
注意 このプロパティは、Windows 8 以降のバージョンの Windows でのみサポートされます。

インバウンド COM 呼び出しの実行中に発生する可能性のあるクラッシュやその他の例外を検出するアプリケーション (たとえばローカルサーバーへの呼び出しや IDropTarget::Drop メソッドの実行時) では、例外をキャッチする COM の動作を無効化するために COMGLB_EXCEPTION_HANDLING を COMGLB_EXCEPTION_DONOT_HANDLE に設定することが重要です。これを行わないと、プロセスの状態が破損する可能性があります。たとえば、これらの例外がスローされた際に保持されていたロックが放棄され、プロセスが一貫性のない状態に陥る可能性があります。

そのようなアプリケーションはすべて、起動時にこのコードを実行する必要があります。

    IGlobalOptions *pGlobalOptions;
    hr =  CoCreateInstance(CLSID_GlobalOptions, NULL, CLSCTX_INPROC_SERVER, IID_PPV_ARGS(&pGlobalOptions));
    if (SUCCEEDED(hr))
    {
        hr = pGlobalOptions->Set(COMGLB_EXCEPTION_HANDLING, COMGLB_EXCEPTION_DONOT_HANDLE);
        pGlobalOptions->Release();
    }

メソッド 2

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT Set(GLOBALOPT_PROPERTIES dwProperty, UINT_PTR dwValue)

IGlobalOptions::Set (objidlbase.h) メソッドは、指定した COM ランタイムのグローバルプロパティを設定します。

dwPropertyGLOBALOPT_PROPERTIESinCOM ランタイムのグローバルプロパティです。このメソッドで設定できるプロパティの一覧については、IGlobalOptions を参照してください。
dwValueUINT_PTRin

プロパティの値です。

重要 COMGLB_APPID プロパティの場合、このパラメーターには APPID GUID へのポインターを指定する必要があります。

戻り値

プロパティが正常に設定された場合、戻り値は S_OK です。

vtbl 4 HRESULT Query(GLOBALOPT_PROPERTIES dwProperty, UINT_PTR* pdwValue)

IGlobalOptions::Query (objidlbase.h) メソッドは、指定した COM ランタイムのグローバルプロパティを照会します。

dwPropertyGLOBALOPT_PROPERTIESinCOM ランタイムのグローバルプロパティです。このメソッドで設定できるプロパティの一覧については、IGlobalOptions を参照してください。
pdwValueUINT_PTR*out

プロパティの値です。

重要 COMGLB_APPID プロパティの場合、このパラメーターは AppID GUID へのポインターを受け取ります。

戻り値

プロパティが正常に照会された場合、戻り値は S_OK です。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IGlobalOptions "{0000015B-0000-0000-C000-000000000046}"
#usecom global IGlobalOptions IID_IGlobalOptions "{}"
#comfunc global IGlobalOptions_Set    3 int,sptr
#comfunc global IGlobalOptions_Query  4 int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。