CLSCTX 列挙 (wtypesbase.h)

[アーティクル]
11/20/2024

オブジェクトを実行する実行コンテキストを示すためにアクティブ化呼び出しで使用される値。これらの値は、CoRegisterClassObject の呼び出しでも使用され、インスタンスを構築する要求に対してクラスオブジェクトを使用できるようにする実行コンテキストのセットを示します。

構文

typedef enum tagCLSCTX {
  CLSCTX_INPROC_SERVER = 0x1,
  CLSCTX_INPROC_HANDLER = 0x2,
  CLSCTX_LOCAL_SERVER = 0x4,
  CLSCTX_INPROC_SERVER16 = 0x8,
  CLSCTX_REMOTE_SERVER = 0x10,
  CLSCTX_INPROC_HANDLER16 = 0x20,
  CLSCTX_RESERVED1 = 0x40,
  CLSCTX_RESERVED2 = 0x80,
  CLSCTX_RESERVED3 = 0x100,
  CLSCTX_RESERVED4 = 0x200,
  CLSCTX_NO_CODE_DOWNLOAD = 0x400,
  CLSCTX_RESERVED5 = 0x800,
  CLSCTX_NO_CUSTOM_MARSHAL = 0x1000,
  CLSCTX_ENABLE_CODE_DOWNLOAD = 0x2000,
  CLSCTX_NO_FAILURE_LOG = 0x4000,
  CLSCTX_DISABLE_AAA = 0x8000,
  CLSCTX_ENABLE_AAA = 0x10000,
  CLSCTX_FROM_DEFAULT_CONTEXT = 0x20000,
  CLSCTX_ACTIVATE_X86_SERVER = 0x40000,
  CLSCTX_ACTIVATE_32_BIT_SERVER,
  CLSCTX_ACTIVATE_64_BIT_SERVER = 0x80000,
  CLSCTX_ENABLE_CLOAKING = 0x100000,
  CLSCTX_APPCONTAINER = 0x400000,
  CLSCTX_ACTIVATE_AAA_AS_IU = 0x800000,
  CLSCTX_RESERVED6 = 0x1000000,
  CLSCTX_ACTIVATE_ARM32_SERVER = 0x2000000,
  CLSCTX_ALLOW_LOWER_TRUST_REGISTRATION,
  CLSCTX_PS_DLL = 0x80000000
} CLSCTX;

定数


`CLSCTX_INPROC_SERVER` 値: 0x1 このクラスのオブジェクトを作成および管理するコードは、クラスコンテキストを指定する関数の呼び出し元と同じプロセスで実行される DLL です。
`CLSCTX_INPROC_HANDLER` 値: 0x2 このクラスのオブジェクトを管理するコードは、インプロセスハンドラーです。これは、クライアントプロセスで実行され、クラスのインスタンスがリモートでアクセスされるときに、このクラスのクライアント側構造を実装する DLL です。
`CLSCTX_LOCAL_SERVER` 値: 0x4 このクラスのオブジェクトを作成および管理する EXE コードは、同じコンピューター上で実行されますが、別のプロセス空間に読み込まれます。
`CLSCTX_INPROC_SERVER16` 値: 0x8 廃れた。
`CLSCTX_REMOTE_SERVER` 値: 0x10 リモートコンテキスト。このクラスのオブジェクトを作成および管理する LocalService コード LocalServer32 またはは、別のコンピューターで実行されます。
`CLSCTX_INPROC_HANDLER16` 値: 0x20 廃れた。
`CLSCTX_RESERVED1` 値: 0x40 引っ込み思案。
`CLSCTX_RESERVED2` 値: 0x80 引っ込み思案。
`CLSCTX_RESERVED3` 値: 0x100 引っ込み思案。
`CLSCTX_RESERVED4` 値: 0x200 引っ込み思案。
`CLSCTX_NO_CODE_DOWNLOAD` 値: 0x400 ディレクトリサービスまたはインターネットからのコードのダウンロードを無効にします。このフラグは、CLSCTX_ENABLE_CODE_DOWNLOADと同時に設定することはできません。
`CLSCTX_RESERVED5` 値: 0x800 引っ込み思案。
`CLSCTX_NO_CUSTOM_MARSHAL` 値: 0x1000 カスタムマーシャリングを使用している場合にアクティブ化を失敗させるかどうかを指定します。
`CLSCTX_ENABLE_CODE_DOWNLOAD` 値: 0x2000 ディレクトリサービスまたはインターネットからコードをダウンロードできるようにします。このフラグは、CLSCTX_NO_CODE_DOWNLOADと同時に設定することはできません。
`CLSCTX_NO_FAILURE_LOG` 値: 0x4000 CLSCTX_NO_FAILURE_LOGを使用して、CoCreateInstanceExエラーのログ記録をオーバーライドできます。 ActivationFailureLoggingLevel が作成された場合、次の値によってイベントログの状態が決まります。 0 = 随意ログ記録。既定ではログを記録しますが、クライアントは CoCreateInstanceExでCLSCTX_NO_FAILURE_LOG 指定することでオーバーライドできます。 1 = クライアントが指定した内容に関係なく、すべてのエラーを常にログに記録します。 2 = 指定したクライアントに関係なく、エラーをログに記録しません。レジストリエントリが見つからない場合、既定値は 0 です。顧客アプリケーションを制御する必要がある場合は、この値を 0 に設定し、エラーをオーバーライドするクライアントコードを記述することをお勧めします。値を 2 に設定しないことを強くお勧めします。イベントログが無効になっている場合は、問題の診断が困難になります。
`CLSCTX_DISABLE_AAA` 値: 0x8000 このアクティブ化に対してのみ、アクティブ化 (AAA) アクティブ化を無効にします。このフラグは、EOLE_AUTHENTICATION_CAPABILITIES列挙体のEOAC_DISABLE_AAA フラグの設定をオーバーライドします。このフラグは、CLSCTX_ENABLE_AAAと同時に設定することはできません。呼び出し元の ID でサーバープロセスが起動されるアクティブ化は、アクティブ化 (AAA) アクティブ化と呼ばれます。 AAA アクティベーションを無効にすると、特権アカウント (LocalSystem など) で実行されるアプリケーションは、その ID が信頼されていないコンポーネントの起動に使用されるのを防ぐことができます。アクティブ化呼び出しを使用するライブラリアプリケーションでは、これらの呼び出し中に常にこのフラグを設定する必要があります。これにより、特権のエスカレーションセキュリティ攻撃でライブラリアプリケーションが使用されるのを防ぐことができます。ライブラリアプリケーションで AAA アクティベーションを無効にする唯一の方法は、EOLE_AUTHENTICATION_CAPABILITIES列挙からのEOAC_DISABLE_AAA フラグが、ライブラリアプリケーションではなく、サーバープロセスにのみ適用されるためです。 Windows 2000: このフラグはサポートされていません。
`CLSCTX_ENABLE_AAA` 値: 0x10000 このアクティブ化に対してのみ、アクティブ化 (AAA) アクティブ化を有効にします。このフラグは、EOLE_AUTHENTICATION_CAPABILITIES列挙体のEOAC_DISABLE_AAA フラグの設定をオーバーライドします。このフラグは、CLSCTX_DISABLE_AAAと同時に設定することはできません。呼び出し元の ID でサーバープロセスが起動されるアクティブ化は、アクティブ化 (AAA) アクティブ化と呼ばれます。このフラグを有効にすると、アプリケーションはその ID をアクティブ化されたコンポーネントに転送できます。 Windows 2000: このフラグはサポートされていません。
`CLSCTX_FROM_DEFAULT_CONTEXT` 値: 0x20000 このアクティブ化は、現在のアパートメントの既定のコンテキストから開始します。
`CLSCTX_ACTIVATE_X86_SERVER` 値: 0x40000
`CLSCTX_ACTIVATE_32_BIT_SERVER` サーバーの 32 ビットバージョンをアクティブ化または接続する。登録されていない場合は失敗します。
`CLSCTX_ACTIVATE_64_BIT_SERVER` 値: 0x80000 サーバーの 64 ビットバージョンをアクティブ化または接続する。登録されていない場合は失敗します。
`CLSCTX_ENABLE_CLOAKING` 値: 0x100000 このフラグを指定すると、COM はスレッドによって行われたアクティブ化要求に対して、スレッドの偽装トークン (存在する場合) を使用します。このフラグが指定されていない場合、またはスレッドに偽装トークンがない場合、COM はスレッドによって行われたアクティブ化要求に対してスレッドのプロセストークンを使用します。 Windows Vista 以降: このフラグがサポートされています。
`CLSCTX_APPCONTAINER` 値: 0x400000 アクティブ化がアプリコンテナー用であることを示します。注このフラグは内部使用のために予約されており、コードから直接使用するためのものではありません。
`CLSCTX_ACTIVATE_AAA_AS_IU` 値: 0x800000 As-Activator サーバーの対話型ユーザーアクティブ化動作にこのフラグを指定します。厳密な名前の Medium IL Windows ストアアプリでは、このフラグを使用して、厳密な名前を持たない "As Activator" COM サーバーを起動できます。また、このフラグを使用して、デスクトップアプリケーションによって起動される COM サーバーの実行中のインスタンスにバインドすることもできます。クライアントは Medium IL である必要があります。厳密な名前を付ける必要があります。つまり、クライアントトークンに SysAppID があり、セッション 0 に含まれず、クライアントトークン内のセッション ID のユーザーと同じユーザーが必要です。サーバーがアウトプロセスで "アクティベーター" の場合は、クライアントトークンのセッションユーザーのトークンを使用してサーバーを起動します。このトークンには厳密な名前は付けられません。サーバーがアウトプロセスで RunAs "Interactive User" の場合、このフラグは無効です。サーバーがアウトプロセスで、他の RunAs 型の場合、アクティブ化は失敗します。このフラグは、インプロセスサーバーには影響しません。このフラグを使用すると、マシン外のアクティブ化は失敗します。
`CLSCTX_RESERVED6` 値: 0x1000000
`CLSCTX_ACTIVATE_ARM32_SERVER` 値: 0x2000000
`CLSCTX_PS_DLL` 値: 0x80000000 プロキシ/スタブ DLL の読み込みに使用されます。注このフラグは内部使用のために予約されており、コードから直接使用するためのものではありません。

備考

CLSCTX 列挙の値は、アクティブ化呼び出し (CoCreateInstance、CoCreateInstanceEx、CoGetClassObjectなど) で使用され、オブジェクトを実行する優先実行コンテキスト (インプロセス、ローカル、リモート) を示します。また、CoRegisterClassObject の呼び出しでも使用され、インスタンスを構築する要求でクラスオブジェクトを使用できるようにする実行コンテキストのセットを示します (IClassFactory::CreateInstance)。

複数のコンテキストが許容されることを示すために、複数の値をブール型の OR と組み合わせることができます。コンテキストは、一覧表示されている順序で試行されます。

CLSCTX フラグのセット指定すると、使用される実行コンテキストは、登録されたクラスコードの可用性と、次のアルゴリズムに従ったその他のパラメーターによって異なります。

呼び出しで次のいずれかが指定されている場合、CLSCTX_REMOTE_SERVERは暗黙的に指定され、フラグの一覧に追加されます。
1. 現在のコンピューターとは異なるコンピューターを示す明示的な COSERVERINFO 構造体。
2. 明示的な COSERVERINFO 構造体は指定されていませんが、指定したクラスは、RemoteServerName または ActivateAtStorage レジストリ値のいずれかに登録されます。
2 番目のケースでは、分散 COM のリリース前に記述されたアプリケーションを、DCOM および CLSCTX_REMOTE_SERVER フラグの前に使用可能なクライアントアプリケーションで使用するリモートアクティブ化のクラスの構成にすることができます。 COSERVERINFO 構造体明示的に存在しないケースは、値が NULL として指定されている場合、または値が関数パラメーターの 1 つでない場合です (CoCreateInstance と CoGetClassObject呼び出しの場合と同様)。
明示的な COSERVERINFO パラメーターが現在のコンピューターを示している場合、CLSCTX_REMOTE_SERVERが存在する場合は削除されます。

残りの処理は、次のシーケンスの値を調べることで続行されます。

フラグにCLSCTX_REMOTE_SERVERが含まれ、COSERVERINFO パラメーター指定されておらず、アクティブ化要求がオブジェクトの初期化元の永続的な状態を示す場合 (coGetInstanceFromFile、CoGetInstanceFromIStorage、またはファイルモニカーの場合、IMoniker::BindToObject) をする呼び出しで、クラスに ActivateAtStorage サブキーが含まれているか、クラスレジストリ情報がありません。アクティブ化と初期化の要求は、永続的な状態が存在するコンピューターに転送されます。 (詳細については、「関連項目」セクションに記載されているリモート・アクティベーション機能を参照してください。
フラグにCLSCTX_INPROC_SERVERが含まれている場合、このキーが存在する場合は、クラスの InprocServer32 キーの下にある DLL 内のクラスコードが使用されます。クラスコードは、呼び出し元と同じプロセス内で実行されます。
フラグにCLSCTX_INPROC_HANDLERが含まれている場合、このキーが存在する場合は、クラスの InprocHandler32 キーの下にある DLL 内のクラスコードが使用されます。クラスコードは、呼び出し元と同じプロセス内で実行されます。
フラグにCLSCTX_LOCAL_SERVERが含まれている場合、このキーが存在する場合は、クラスの LocalService キーの下にあるサービス内のクラスコードが使用されます。サービスが指定されていないが、同じキーの下に EXE が指定されている場合は、その EXE に関連付けられているクラスコードが使用されます。クラスコード (どちらの場合も) は、呼び出し元と同じコンピューター上の別のサービスプロセスで実行されます。
フラグが CLSCTX_REMOTE_SERVER に設定され、関数に追加 COSERVERINFO パラメーターによって特定のリモートコンピューターが指定されている場合、アクティブ化要求は、フラグが CLSCTX_LOCAL_SERVER に設定されるように変更された状態で、このリモートコンピューターに転送されます。クラスコードは、この特定のコンピューター上で独自のプロセスで実行されます。呼び出し元とは異なる必要があります。
最後に、フラグにCLSCTX_REMOTE_SERVERが含まれており、COSERVERINFO パラメーター指定されておらず、クラスの RemoteServerName 名前付き値の下にコンピューター名が指定されている場合、アクティブ化の要求は、CLSCTX_LOCAL_SERVERに設定するように変更されたフラグを使用して、このリモートコンピューターに転送されます。クラスコードは、この特定のコンピューター上で独自のプロセスで実行されます。呼び出し元とは異なる必要があります。

CLSCTX_ACTIVATE_32_BIT_SERVER とCLSCTX_ACTIVATE_64_BIT_SERVER

Windows の 64 ビットバージョンでは、CLSCTX_ACTIVATE_32_BIT_SERVERとCLSCTX_ACTIVATE_64_BIT_SERVERの 2 つの新しいフラグが導入されています。 64 ビットコンピューターでは、同じ COM サーバーの 32 ビットバージョンと 64 ビットバージョンが共存する場合があります。クライアントがアウトプロセスサーバーのアクティブ化を要求すると、これらの CLSCTX フラグにより、クライアントは 32 ビットバージョンまたは 64 ビットバージョンのサーバーを指定できます。

通常、クライアントは、サーバーの 32 ビットバージョンと 64 ビットバージョンのどちらを使用しているかは気にしません。ただし、サーバー自体が追加のインプロセスサーバーを読み込む場合は、サーバーとインプロセスサーバーの両方が 32 ビットまたは 64 ビットである必要があります。たとえば、クライアントがサーバー "A" を使用し、インプロセスサーバー "B" を読み込むとします。 32 ビットバージョンのサーバー "B" のみを使用できる場合、クライアントはサーバー "A" の 32 ビットバージョンを指定する必要があります。サーバー "B" の 64 ビットバージョンのみを使用できる場合、クライアントはサーバー "A" の 64 ビットバージョンを指定する必要があります。

サーバーは、PreferredServerBitness レジストリキーを使用して独自のアーキテクチャ設定を指定できますが、CLSCTX_ACTIVATE_32_BIT_SERVERまたは CLSCTX_ACTIVATE_64_BIT_SERVER フラグを使用して指定されたクライアントの基本設定は、サーバーの基本設定をオーバーライドします。クライアントが基本設定を指定しない場合は、サーバーの基本設定が使用されます。

クライアントとサーバーのどちらも優先設定を指定しない場合は、次のようにします。

サーバーをホストするコンピューターが Windows Server 2003 Service Pack 1 (SP1) 以降のシステムを実行している場合、COM はサーバーアーキテクチャとクライアントアーキテクチャの照合を試みます。つまり、32 ビットクライアントの場合、COM は 32 ビットサーバー (使用可能な場合) をアクティブにします。それ以外の場合は、64 ビットバージョンのサーバーがアクティブになります。 64 ビットクライアントの場合、COM は 64 ビットサーバー (使用可能な場合) をアクティブにします。それ以外の場合は、32 ビットサーバーがアクティブになります。
サーバーをホストするコンピューターが、SP1 以降がインストールされていない Windows XP または Windows Server 2003 を実行している場合、COM は 64 ビットバージョンのサーバー (使用可能な場合) を優先します。それ以外の場合は、32 ビットバージョンのサーバーがアクティブになります。

CLSCTX 列挙型にCLSCTX_ACTIVATE_32_BIT_SERVERフラグとCLSCTX_ACTIVATE_64_BIT_SERVER フラグの両方が設定されている場合、無効になり、アクティブ化によってE_INVALIDARGが返されます。

次の表は、クライアントアーキテクチャとクライアント設定、サーバーアーキテクチャ、サーバー設定のさまざまな組み合わせの結果を示しています。

フラグCLSCTX_ACTIVATE_32_BIT_SERVERし、コンピューターの境界を越えてCLSCTX_ACTIVATE_64_BIT_SERVERフローします。サーバーをホストするコンピューターが 64 ビット Windows を実行している場合は、これらのフラグが適用されます。それ以外の場合は無視されます。

	32 ビットクライアント、フラグなし	64 ビットクライアント、フラグなし	32 ビットクライアント、32 ビットフラグ¹	32 ビットクライアント、64 ビットフラグ²	64 ビットクライアント、32 ビットフラグ¹	64 ビットクライアント、64 ビットフラグ²
32 ビットサーバー、クライアントレジストリ値に一致する ²	32 ビットサーバー	⁸ を参照	32 ビットサーバー	⁸ を参照	32 ビットサーバー	⁸ を参照
32 ビットサーバー、32 ビットレジストリ値⁴	32 ビットサーバー	32 ビットサーバー	32 ビットサーバー	⁸ を参照	32 ビットサーバー	⁸ を参照
32 ビットサーバー、64 ビットレジストリ値⁵	⁸ を参照	⁸ を参照	32 ビットサーバー	⁸ を参照	32 ビットサーバー	⁸ を参照
32 ビットサーバー、レジストリ値なし⁶	32 ビットサーバー	64/32⁹	32 ビットサーバー	⁸ を参照	32 ビットサーバー	⁸ を参照
32 ビットサーバー、レジストリ値なし (Windows Server 2003 SP1 より前)⁷	64/32⁹	64/32⁹	32 ビットサーバー	⁸ を参照	32 ビットサーバー	⁸ を参照
64 ビットサーバー、クライアントレジストリ値に一致する ²	⁸ を参照	64 ビットサーバー	⁸ を参照	64 ビットサーバー	⁸ を参照	64 ビットサーバー
64 ビットサーバー、32 ビットレジストリ値⁴	⁸ を参照	⁸ を参照	⁸ を参照	64 ビットサーバー	⁸ を参照	64 ビットサーバー
64 ビットサーバー、64 ビットレジストリ値⁵	64 ビットサーバー	64 ビットサーバー	⁸ を参照	64 ビットサーバー	⁸ を参照	64 ビットサーバー
64 ビットサーバー、レジストリ値なし⁶	32/64¹⁰	64 ビットサーバー	⁸ を参照	64 ビットサーバー	⁸ を参照	64 ビットサーバー
64 ビットサーバー、レジストリ値なし (Windows Server 2003 SP1 より前)⁷	64 ビットサーバー	64 ビットサーバー	⁸ を参照	64 ビットサーバー	⁸ を参照	64 ビットサーバー

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップアプリのみ]
ヘッダー	wtypesbase.h

次の方法で共有

CLSCTX 列挙 (wtypesbase.h)

構文

定数

備考

CLSCTX_ACTIVATE_32_BIT_SERVER とCLSCTX_ACTIVATE_64_BIT_SERVER

必要条件

関連項目

フィードバック

その他のリソース