Share via

アプリケーション コレクション

  • [アーティクル]

ローカル コンピューターにインストールされている COM+ アプリケーションごとに 1 つのオブジェクトが含まれます。 これらのオブジェクトによって公開されるプロパティは、アプリケーション レベルで行われたすべての設定を保持します。

関連する Components コレクションを使用して、アプリケーション内の コンポーネント のプロパティを設定します。 関連する Roles コレクションを使用して、アプリケーションに ロール を割り当てます。

アプリケーションにコンポーネントをインストールするには、 COMAdminCatalog オブジェクトのメソッドを使用します。 ファイルからアプリケーションをインストールしたり、アプリケーションをシャットダウンまたはエクスポートしたりするには、 COMAdminCatalog オブジェクトの メソッドも使用します。 それ以外の場合は、新しいアプリケーションを作成するために、 Applications コレクションに オブジェクトを追加できます。

このコレクションは、COMAdminCatalogCollection オブジェクトの Add メソッドと Remove メソッドをサポートしています。

メンバー

Applications コレクションは IUnknown インターフェイスから継承されますが、追加のメンバーはありません。

このコレクションから次のいずれかのコレクションに移動できます。

このコレクションには、次のコレクションから移動できます。

プロパティ

次のプロパティは、コレクション内の COMAdminCatalogObject オブジェクトでサポートされています。

3GigSupportEnabled

入力 値
説明 アプリケーションがそのプロセスで 3 GB のメモリを使用できるかどうかを示します。 これが有効になっていない場合、アプリケーションは 2 GB のメモリのみを使用できます。
Access ReadWrite
Type Bool
Default 誤
最小システム Windows 2000

 

AccessChecksLevel

入力 値
説明 アクセス チェックがプロセス レベルでのみ実行されるか、プロセス レベルとコンポーネント レベルの両方で実行されるかを示します。 数値ではなく、列挙で定数を使用することをお勧めします。
Access ReadWrite
Type 有効な長い値: COMAdminAccessChecksApplicationLevel (0) COMAdminAccessChecksApplicationComponentLevel (1)
Default COMAdminAccessChecksApplicationComponentLevel (1)
最小システム Windows 2000

 

アクティブ化

入力 値
説明 ローカル アクティブ化は、アプリケーション内のオブジェクトが専用のローカル サーバー プロセス (サーバー アプリケーション) 内で実行されることを示します。 インプロセス アクティブ化は、オブジェクトが作成者のプロセス (ライブラリ アプリケーション) で実行されることを示します。
Access ReadWrite
Type Long Possible values:COMAdminActivationInproc (0)COMAdminActivationLocal (1)
Default COMAdminActivationLocal (1)
最小システム Windows 2000

 

ApplicationAccessChecksEnabled

入力 値
説明 クライアントが呼び出しを行うときに、アプリケーションに対してアクセス チェックを実行するかどうかを示します。
Access ReadWrite
Type Bool
Default True
最小システム Windows 2000

 

ApplicationDirectory

入力 値
説明 アプリケーションへの完全なパス。 この情報は、Side-by-Side (SxS) アセンブリを構成するときに必要です。 サイド バイ サイド (SxS) アセンブリを使用すると、ASP アプリケーションは、MSVCRT、MSXML、COMCTL、GDIPLUS など、使用する SxS でサポートされるシステム DLL のバージョンを指定できます。 たとえば、ASP アプリケーションが MSVCRT バージョン 2.0 に依存している場合、サービス パックがサーバーに適用された後でも、アプリケーションで MSVCRT バージョン 2.0 が引き続き使用されるようにすることができます。 MSVCRT の新しいバージョンは引き続きコンピューターにインストールされますが、バージョン 2.0 は残り、アプリケーションで使用されます。 SxS でサポートされる DLL は、%WINDIR%\WinSxS に格納されます。
Access ReadWrite
Type 文字列型
Default ""
最小システム Windows XP

 

Note

この機能はアプリケーション レベルで構成できますが、任意のアプリケーション プールで使用できるシステム DLL のバージョンは 1 つだけです。 たとえば、アプリケーション App1 で MSVCRT バージョン 2.5 が使用され、アプリケーション App2 で MSVCRT バージョン 2.4 が使用されている場合、App1 と App2 は同じアプリケーション プール内にありません。 その場合、最初に読み込まれるアプリケーションには MSVCRT のバージョンが読み込まれ、他のアプリケーションはアプリケーションがアンロードされるまで強制的に使用されます。

 

詳細については、「 IIS 6.0 の COM+ サービスの変更」の「Side-by-Side アセンブリ」を参照してください。

ApplicationProxy

入力 値
説明 アプリケーションがアプリケーション プロキシであるかどうかを示します。
Access ReadOnly
Type Bool
Default 誤
最小システム Windows 2000

 

ApplicationProxyServerName

入力 値
説明 アプリケーション プロキシをエクスポートするときに使用されるリモート サーバー名。 これは、アプリケーション プロキシがクライアント コンピューターにインストールされるときに指すこのサーバー名です。
Access ReadWrite
Type 文字列型
Default ""
最小システム Windows 2000

 

AppPartitionID

入力 値
説明 アプリケーション パーティション ID を表す GUID。
Access ReadOnly
Type 文字列型
Default <自動生成>
最小システム Windows Server 2003

 

認証

入力 値
説明 リモート プロシージャ コール (RPC) 認証設定に対応する値を使用して、呼び出しの認証レベルを設定します。 COMAdminAuthenticationDefault を選択すると、 LocalComputer コレクション内の DefaultAuthenticationLevel プロパティの設定が使用されます。
Access ReadWrite
Type Long Possible values:COMAdminAuthenticationDefault (0)COMAdminAuthenticationNone (1) COMAdminAuthenticationConnect (2)COMAdminAuthenticationCall (3)COMAdminAuthenticationPacket (4)COMAdminAuthenticationIntegrity (5)COMAdminAuthenticationPrivacy (6)
Default COMAdminAuthenticationPacket (4)
最小システム Windows 2000

 

Note

ライブラリ (インプロセス) アプリケーションの場合、ここで有効な設定は COMAdminAuthenticationDefault と COMAdminAuthenticationNone だけです。 数値ではなく、列挙で定数を使用することをお勧めします。

 

AuthenticationCapability

入力 値
説明 呼び出しが偽装されるときに表示される ID を決定します。
Access ReadWrite
Type Long Possible values:COMAdminAuthenticationCapabilitiesNone (0x0)COMAdminAuthenticationCapabilitiesSecureReference (0x2)COMAdminAuthenticationCapabilitiesStaticCloaking (0x20)COMAdminAuthenticationCapabilitiesDynamicCloaking (0x40)
Default COMAdminAuthenticationCapabilitiesDynamicCloaking (0x40)
最小システム Windows 2000

 

変更可能

入力 値
説明 プログラムまたはコンポーネント サービス管理ツールを使用して、アプリケーション設定またはそのコンポーネントの変更を許可するかどうかを決定します。
Access ReadWrite
Type Bool
Default True
最小システム Windows 2000

 

CommandLine

入力 値
説明 デバッグで使用するコマンド ライン文字列。 アプリケーションは、指定したコマンド ラインを使用してデバッガーで起動できます。
Access ReadWrite
Type 文字列型
Default ""
最小システム Windows 2000

 

ConcurrentApps

入力 値
説明 同時に実行できるプール可能なアプリケーションの最大数を指定します。
Access ReadWrite
Type Long (1-1048576)
Default 1
最小システム Windows XP

 

CreatedBy

入力 値
説明 アプリケーションを作成したユーザーを示す情報文字列。
Access ReadWrite
Type 文字列型
Default ""
最小システム Windows 2000

 

CRMEnabled

入力 値
説明 補正Resource Managerが有効かどうかを判断します。
Access ReadWrite
Type Bool
Default 誤
最小システム Windows 2000

 

CRMLogFile

入力 値
説明 補正リソース マネージャー (CRM) のログを保持するためのファイルの名前とパス。
Access ReadWrite
Type 文字列型
Default ""
最小システム Windows 2000

 

削除可能

入力 値
説明 プログラムまたはコンポーネント サービス管理ツールを使用して、アプリケーションを削除できるかどうかを設定します。
Access ReadWrite
Type Bool
Default True
最小システム Windows 2000

 

説明

入力 値
説明 アプリケーションについて説明します。
Access ReadWrite
Type 文字列型
Default ""
最小システム Windows 2000

 

DumpEnabled

入力 値
説明 指定されたディレクトリへの障害発生時の COM+ アプリケーションの状態のダンプを有効にします。
Access ReadWrite
Type Bool
Default 誤
最小システム Windows XP

 

Note

Windows Server 2003 の時点では、COM+ ダンプ ファイルに対する読み取りアクセス権を持つのは管理者のみです。

 

DumpOnException

入力 値
説明 アプリケーションで未処理の例外が発生し、COM+ ランタイムによって終了された場合に、COM+ アプリケーションの状態のダンプを有効にします。
Access ReadWrite
Type Bool
Default 誤
最小システム Windows XP

 

DumpOnFailfast

入力 値
説明 アプリケーションが失敗した場合の COM+ アプリケーションの状態のダンプを有効にします。
Access ReadWrite
Type Bool
Default 誤
最小システム Windows XP

 

DumpPath

入力 値
説明 ダンプ ファイルが保存されるディレクトリのパス。
Access ReadWrite
Type 文字列型
Default "%systemroot%\system32\com\dmp"
最小システム Windows XP

 

Note

Windows Server 2003 の時点では、COM+ ダンプ ファイルに対する読み取りアクセス権を持つのは管理者のみです。

 

EventsEnabled

入力 値
説明 アプリケーションに対してイベントが有効になっているかどうかを示します。
Access ReadWrite
Type Bool
Default True
最小システム Windows 2000

 

id

入力 値
説明 アプリケーションを表す GUID。 このプロパティは、このコレクションのオブジェクトで Key プロパティ メソッドが呼び出されたときに返されます。
Access WriteOnce
Type 文字列型
Default <自動生成>
最小システム Windows 2000

 

ID

入力 値
説明 アプリケーションのサーバー プロセス ID を設定します。 有効なユーザー アカウントまたは "対話型ユーザー" を指定して、アプリケーションで現在ログオンしているユーザーの ID を想定させます。 文字列 "nt authority\localservice"、"nt authority\networkservice"、および "nt authority\system" を指定することもできます。 これら 3 つのアカウントの既定のパスワードは "" (空の文字列) です。
Access
Type
Default
最小システム Windows 2000

 

Identity プロパティは、クライアント プロセスで実行されるライブラリ アプリケーションでは有効になっていません。

パスワードと ID が保存される前に検証されるため、 SaveChanges を使用する前に、Identity と同時に Password プロパティを設定する必要があります。 パスワードと ID が同期を取り消した場合、アプリケーションは管理者によってリセットされるまで起動できません。

ImpersonationLevel

入力 値
説明 他のアプリケーションへの呼び出しに使用される偽装レベルを設定します。
Access ReadWrite
Type Long 可能な値:COMAdminImpersonationAnonymous (1)COMAdminImpersonationIdentify (2)COMAdminImpersonationImpersonate (3)COMAdminImpersonationDelegate (4)
Default COMAdminImpersonationImpersonate (3)
最小システム Windows 2000

 

IsEnabled

入力 値
説明 COM+ アプリケーションまたはコンポーネントが無効になっている場合、IsEnabled は False です。 COM+ アプリケーションまたはコンポーネントが有効になっている場合、IsEnabled は True です。
Access ReadWrite
Type Bool
Default True
最小システム Windows XP

 

IsSystem

入力 値
説明 COM+ システム アプリケーションを識別します。
Access ReadOnly
Type Bool
Default 誤
最小システム Windows 2000

 

MaxDumpCount

入力 値
説明 上書きが発生する前に生成されるファイルの最大数を示します。
Access ReadWrite
Type Long (1 から 200)
Default 5
最小システム Windows XP

 

名前

入力 値
説明 アプリケーションの名前です。 文字列の先頭と末尾に余分なスペースが取り除かれます。このプロパティは、このコレクションのオブジェクトで Name プロパティ メソッドが呼び出されたときに返されます。
Access ReadWrite
Type 文字列型
Default "新しいアプリケーション"
最小システム Windows 2000

 

注意

アプリケーションには一意の名前を選択する必要があります。 同じ名前で複数のアプリケーションが作成されると、アプリケーションの名前による参照が妨げられ、予期しない動作が発生する可能性があります。

 

パスワード

入力 値
説明 ID の下でログオンするためにサーバー プロセスで使用されるパスワードを設定します。
Access WriteOnly
Type 文字列型
Default ""
最小システム Windows 2000

 

パスワードと ID は保存される前に検証されるため、 SaveChanges を使用する前に、ID と同時にパスワードを設定する必要があります。 パスワードと ID が同期を取り消した場合、アプリケーションは管理者によってリセットされるまで起動できません。

QCAuthenticateMsgs

入力 値
説明 アプリケーションに対してキューに登録された要求が認証される状況を示します。
Access ReadWrite
Type Long 可能な値:COMAdminQCMessageAuthenticateSecureApps (0)COMAdminQCMessageAuthenticateOff (1)COMAdminQCMessageAuthenticateOn (2)
Default COMAdminQCMessageAuthenticateSecureApps (0)
最小システム Windows XP

 

QCListenerMaxThreads

入力 値
説明 同時リスナー スレッドの最大数を示します。 このプロパティの有効な範囲は 0 から 1000 です。 新しく作成されたアプリケーションの場合、この設定は、リスナー スレッドの既定の数 (サーバー内の CPU の数の 16 倍) を決定するために現在使用されているアルゴリズムから派生します。
Access ReadWrite
Type Long (0 から 1000)
Default 0
最小システム Windows XP

 

注意

このプロパティは、コンポーネント サービス管理ツールの [ キュー ] タブから読み取り/書き込み機能でも使用できます。

 

QueueListenerEnabled

入力 値
説明 キューに登録されたコンポーネント リスナーがアプリケーションに対して有効になっているかどうかを示します。 有効にすると、アプリケーションの起動時にリスナーが起動します。 このプロパティは、QueuingEnabled が True に設定されている場合にのみ有効になります。
Access ReadWrite
Type Bool
Default 誤
最小システム Windows 2000

 

QueuingEnabled

入力 値
説明 COM+ Queued Components サービスがアプリケーションに対して有効になっているかどうかを示します。
Access ReadWrite
Type Bool
Default 誤
最小システム Windows 2000

 

RecycleActivationLimit

入力 値
説明 プロセスをリサイクルする前に受け入れるアプリケーション内の構成済みオブジェクトのアクティブ化の最大数を示します。 アクティブ化の既定の数は 0 です。
Access ReadWrite
Type Long (0-1048576)
Default 0
最小システム Windows XP

 

RecycleCallLimit

入力 値
説明 プロセスをリサイクルする前に、アプリケーションで構成されたオブジェクトが受け入れられる呼び出しの最大数を示します。 呼び出しの既定の数は 0 です。
Access ReadWrite
Type Long (0-1048576)
Default 0
最小システム Windows XP

 

RecycleExpirationTimeout

入力 値
説明 リサイクルされたプロセスをシャットダウンする前に実行できる時間 (分単位) を示します。 カウントダウンは、プロセスがリサイクルされた直後に開始されます。 有効期限の最大タイムアウトは 1440 分 (24 時間) で、既定値は 15 分です。
Access ReadWrite
Type Long (1 から 1440)
Default 15
最小システム Windows XP

 

RecycleLifetimeLimit

入力 値
説明 プロセスをリサイクルする前に実行できる最大時間 (分) を示します。 有効期間の上限は 30240 分 (21 日) で、既定値は 0 分です。
Access ReadWrite
Type Long (0-30240)
Default 0
最小システム Windows XP

 

RecycleMemoryLimit

入力 値
説明 プロセスがリサイクルされる前に許容されるメモリ使用量の最大量 (キロバイト単位) を示します。 プロセス のメモリ使用量が 1 分を超える期間に指定された数を超えた場合、プロセスはリサイクルされます。 メモリ使用量の既定の量は 0 KB です。
Access ReadWrite
Type Long (0-1048576)
Default 0
最小システム Windows XP

 

レプリケート

入力 値
説明 アプリケーションをレプリケートできるかどうかを示します。
Access ReadWrite
Type Bool
Default True
最小システム Windows XP

 

RunForever

入力 値
説明 アプリケーションがアイドル状態の場合にサーバー プロセスを続行できるようにします。 True に設定すると、アイドル状態のままでもサーバー プロセスはシャットダウンされません。 False に設定すると、ShutdownAfter プロパティによって設定された値に従ってプロセスがシャットダウンされます。 RunForever は、ライブラリ (インプロセス) アプリケーションでは有効になっていません。
Access ReadWrite
Type Bool
Default 誤
最小システム Windows 2000

 

ServiceName

入力 値
説明 サービス アプリケーションとして実行するように構成されたアプリケーションに対応するサービス名。 この値が NULL の場合、アプリケーションはサービスとして実行するように構成されていません。 それ以外の場合は、サービス名を使用してサービスの構成情報を確認できます。
Access ReadOnly
Type 文字列型
Default ""
最小システム Windows XP

 

ShutdownAfter

入力 値
説明 アイドル状態になった後にサーバー プロセスをシャットダウンするまでの遅延を設定します。 シャットダウンの待機時間は、0 から 1440 分 (24 時間) の範囲です。 RunForever が True に設定されている場合、このプロパティは無視されます。 ShutdownAfter は、ライブラリ (インプロセス) アプリケーションでは有効になっていません。
Access ReadWrite
Type Long (0 から 1440)
Default 3
最小システム Windows 2000

 

SoapActivated

入力 値
説明 このアプリケーションが SOAP プロトコルを介して使用するために公開されているかどうかを示します。
Access ReadWrite
Type Bool
Default 誤
最小システム Windows Server 2003

 

SoapBaseUrl

入力 値
説明 このアプリケーションが SOAP プロトコルを介して公開される URL エンドポイント。
Access ReadWrite
Type 文字列型
Default ""
最小システム Windows Server 2003

 

SoapMailTo

入力 値
説明 このアプリケーションが SOAP プロトコルを介して公開される電子メール アドレス。
Access ReadWrite
Type 文字列型
Default ""
最小システム Windows Server 2003

 

SoapVRoot

入力 値
説明 SOAP プロトコルを介してアプリケーションを公開するアクセス スクリプトが存在する IIS 仮想ルート ディレクトリ。
Access ReadWrite
Type 文字列型
Default ""
最小システム Windows Server 2003

 

SRPEnabled

入力 値
説明 アプリケーションのソフトウェア制限ポリシー (SRP) を決定します。 True に設定すると、アプリケーションの SRPTrustLevel プロパティが使用されます。 False に設定すると、ローカル セキュリティ設定のソフトウェア制限ポリシーが使用されます。 ローカル セキュリティ設定は、Microsoft 管理コンソールのローカル セキュリティ ポリシー スナップインを使用して制御されます。
Access ReadWrite
Type Bool
Default 誤
最小システム Windows XP

 

SRPTrustLevel

入力 値
説明 アプリケーションのソフトウェア制限ポリシー (SRP) 信頼レベルを示します。 このプロパティは、SRPEnabled プロパティが True に設定されている場合にのみ使用されます。 SRP 信頼レベルとは、アプリケーションに与える信頼のレベルを指します。 無制限の SRP 信頼レベルはSAFER_LEVELID_FULLYTRUSTED列挙型の値に対応し、許可されていない SRP 信頼レベルはSAFER_LEVELID_DISALLOWED列挙型の値に対応します。 信頼レベルの列挙は Winsafer.h で定義されます。
Access ReadWrite
Type Long 可能な値:SAFER_LEVELID_DISALLOWED (0x0)SAFER_LEVELID_FULLYTRUSTED (0x40000)
Default SAFER_LEVELID_FULLYTRUSTED (0x40000)
最小システム Windows XP

 

無制限アクセスで信頼するアプリケーションには、最も厳格なセキュリティがアタッチされている必要があります。 Unrestricted のアプリケーションでは、無制限のコンポーネントのみを読み込むことができますが、許可されていないアプリケーションの実行は許可されないため、コンポーネントを読み込めません。

関連項目

COM+ 管理コレクション