Коллекция Applications

Содержит объект для каждого приложения COM+, установленного на локальном компьютере. Свойства, предоставляемые этими объектами, содержат все параметры, сделанные на уровне приложения.

Свойства компонентов в приложении задаются с помощью связанной коллекции Components . Роли назначаются приложению с помощью связанной коллекции ролей .

Чтобы установить компоненты в приложение, используйте методы в объекте COMAdminCatalog . Чтобы установить приложение из файла, завершить работу или экспортировать приложение, также используйте методы в объекте COMAdminCatalog . В противном случае для создания нового приложения можно добавить объект в коллекцию Applications .

Эта коллекция поддерживает методы Add и Remove объекта COMAdminCatalogCollection .

Элементы

Коллекция Applications наследуется от интерфейса IUnknown , но не имеет дополнительных членов.

Вы можете перейти из этой коллекции в любую из следующих коллекций:

Вы можете перейти к этой коллекции из следующих коллекций:

Свойства

Следующие свойства поддерживаются объектом COMAdminCatalogObject в коллекции:

3GigSupportEnabled

Ввод Значение
Описание Указывает, может ли приложение использовать 3 ГБ памяти в своем процессе. Если этот параметр не включен, приложение может использовать только 2 ГБ памяти.
Access ReadWrite
Тип Bool
Значение по умолчанию Неверно
Минимальная система Windows 2000

 

AccessChecksLevel

Ввод Значение
Описание Указывает, выполняются ли проверки доступа только на уровне процесса или на уровне процесса и компонента. Рекомендуется использовать константы в перечислении, а не числовые значения.
Access ReadWrite
Тип Возможные значения: COMAdminAccessChecksApplicationLevel (0) COMAdminAccessChecksApplicationComponentLevel (1)
По умолчанию COMAdminAccessChecksApplicationComponentLevel (1)
Минимальная система Windows 2000

 

Активация

Ввод Значение
Описание Локальная активация указывает, что объекты в приложении выполняются в выделенном локальном серверном процессе (серверном приложении). Внутрипроцессная активация указывает, что объекты выполняются в процессе их создателя (приложение библиотеки).
Access ReadWrite
Тип Длинные возможные значения:COMAdminActivationInproc (0)COMAdminActivationLocal (1)
По умолчанию COMAdminActivationLocal (1)
Минимальная система Windows 2000

 

ApplicationAccessChecksEnabled

Ввод Значение
Описание Указывает, выполняются ли проверки доступа для приложения при выполнении клиентами его вызовов.
Access ReadWrite
Тип Bool
Значение по умолчанию True
Минимальная система Windows 2000

 

ApplicationDirectory

Ввод Значение
Описание Полный путь к приложению. Эти сведения необходимы при настройке параллельных сборок (SxS). Параллельные сборки (SxS) позволяют приложениям ASP указать, какую версию поддерживаемой SxS системной БИБЛИОТЕКи DLL использовать, например MSVCRT, MSXML, COMCTL, GDIPLUS и т. д. Например, если приложение ASP использует MSVCRT версии 2.0, вы можете убедиться, что приложение по-прежнему использует MSVCRT версии 2.0 даже после применения пакетов обновления к серверу. Любая новая версия MSVCRT по-прежнему устанавливается на компьютере, но версия 2.0 остается и используется приложением. Библиотеки DLL, поддерживаемые SxS, хранятся в папке %WINDIR%\WinSxS.
Access ReadWrite
Тип Строка
По умолчанию ""
Минимальная система Windows XP

 

Примечание

В любом пуле приложений можно использовать только одну версию системной библиотеки DLL, даже если эта функция настраивается на уровне приложения. Например, если приложение App1 использует MSVCRT версии 2.5, а приложение App2 — MSVCRT версии 2.4, то App1 и App2 не должны находиться в одном пуле приложений. Если это так, приложение, которое загружается первым, загружает свою версию MSVCRT, а другое приложение вынуждено использовать ее до тех пор, пока приложения не будут выгружены.

 

Дополнительные сведения см. в разделе Параллельные сборки статьи Изменения в службах COM+ в IIS 6.0.

ApplicationProxy

Ввод Значение
Описание Указывает, является ли приложение прокси приложения.
Access Только для чтения
Тип Bool
Значение по умолчанию Неверно
Минимальная система Windows 2000

 

ApplicationProxyServerName

Ввод Значение
Описание Имя удаленного сервера, используемое при экспорте прокси приложения. Именно на это имя сервера указывает прокси приложения при установке на клиентском компьютере.
Access ReadWrite
Тип Строка
По умолчанию ""
Минимальная система Windows 2000

 

AppPartitionID

Ввод Значение
Описание Идентификатор GUID, представляющий идентификатор секции приложения.
Access Только для чтения
Тип Строка
По умолчанию <Сформировано>
Минимальная система Windows Server 2003

 

Проверка подлинности

Ввод Значение
Описание Задает уровень проверки подлинности для вызовов со значениями, соответствующими параметрам проверки подлинности удаленного вызова процедур (RPC). Если выбран параметр COMAdminAuthenticationDefault, используется параметр в свойстве DefaultAuthenticationLevel в коллекции LocalComputer .
Access ReadWrite
Тип Длинные возможные значения:COMAdminAuthenticationDefault (0)COMAdminAuthenticationNone (1) COMAdminAuthenticationConnect (2)COMAdminAuthenticationCall (3)COMAdminAuthenticationPacket (4)COMAdminAuthenticationIntegrity (5)COMAdminAuthenticationPrivacy (6)
По умолчанию COMAdminAuthenticationPacket (4)
Минимальная система Windows 2000

 

Примечание

Для приложений библиотеки (внутри процесса) единственными допустимыми параметрами являются COMAdminAuthenticationDefault и COMAdminAuthenticationNone. Рекомендуется использовать константы в перечислении, а не числовые значения.

 

AuthenticationCapability

Ввод Значение
Описание Определяет, какое удостоверение отображается при олицетворении вызовов.
Access ReadWrite
Тип Long Possible values:COMAdminAuthenticationCapabilitiesNone (0x0)COMAdminAuthenticationCapabilitiesSecureReference (0x2)COMAdminAuthenticationCapabilitiesStaticCloaking (0x20)COMAdminAuthenticationCapabilitiesDynamicCloaking (0x40)
По умолчанию COMAdminAuthenticationCapabilitiesDynamicCloaking (0x40)
Минимальная система Windows 2000

 

Поддержка изменений

Ввод Значение
Описание Определяет, разрешены ли изменения параметров приложения или его компонентов программными средствами или с помощью средства администрирования служб компонентов.
Access ReadWrite
Тип Bool
Значение по умолчанию True
Минимальная система Windows 2000

 

Командная строка

Ввод Значение
Описание Строка командной строки для использования в отладке. Приложение можно запустить в отладчике с помощью указанной командной строки.
Access ReadWrite
Тип Строка
По умолчанию ""
Минимальная система Windows 2000

 

ConcurrentApps

Ввод Значение
Описание Указывает максимальное количество приложений, доступных в пуле, которые могут выполняться одновременно.
Access ReadWrite
Тип Long (1–1048576)
По умолчанию 1
Минимальная система Windows XP

 

CreatedBy

Ввод Значение
Описание Информационная строка, описывающая, кто создал приложение.
Access ReadWrite
Тип Строка
По умолчанию ""
Минимальная система Windows 2000

 

CRMEnabled

Ввод Значение
Описание Определяет, включена ли Resource Manager компенсации.
Access ReadWrite
Тип Bool
Значение по умолчанию Неверно
Минимальная система Windows 2000

 

CRMLogFile

Ввод Значение
Описание Имя и путь к файлу для хранения журнала для диспетчера ресурсов с компенсацией (CRM).
Access ReadWrite
Тип Строка
По умолчанию ""
Минимальная система Windows 2000

 

Удаляемый

Ввод Значение
Описание Задает возможность удаления приложения программными средствами или с помощью средства администрирования служб компонентов.
Access ReadWrite
Тип Bool
По умолчанию True
Минимальная система Windows 2000

 

Описание

Ввод Значение
Описание Описывает приложение.
Access ReadWrite
Тип Строка
По умолчанию ""
Минимальная система Windows 2000

 

DumpEnabled

Ввод Значение
Описание Включает дамп состояния приложения COM+ во время сбоя в указанном каталоге.
Access ReadWrite
Тип Bool
Значение по умолчанию Неверно
Минимальная система Windows XP

 

Примечание

В Windows Server 2003 только администраторы имеют права доступа на чтение к файлам дампа COM+.

 

DumpOnException

Ввод Значение
Описание Включает дамп состояния приложения COM+, когда приложение вызывает необработанное исключение и завершается средой выполнения COM+.
Access ReadWrite
Тип Bool
Значение по умолчанию Неверно
Минимальная система Windows XP

 

DumpOnFailfast

Ввод Значение
Описание Включает дамп состояния приложения COM+ при сбое приложения.
Access ReadWrite
Тип Bool
Значение по умолчанию Неверно
Минимальная система Windows XP

 

DumpPath

Ввод Значение
Описание Путь к каталогу, в котором сохраняются файлы дампа.
Access ReadWrite
Тип Строка
По умолчанию "%systemroot%\system32\com\dmp"
Минимальная система Windows XP

 

Примечание

В Windows Server 2003 только администраторы имеют права доступа на чтение к файлам дампа COM+.

 

EventsEnabled

Ввод Значение
Описание Указывает, включены ли события для приложения.
Access ReadWrite
Тип Bool
По умолчанию True
Минимальная система Windows 2000

 

ID

Ввод Значение
Описание GUID, представляющий приложение. Это свойство возвращается при вызове метода свойства Key для объекта данной коллекции.
Access WriteOnce
Тип Строка
По умолчанию <Сформировано>
Минимальная система Windows 2000

 

Идентификация

Ввод Значение
Описание Задает удостоверение процесса сервера для приложения. Укажите допустимую учетную запись пользователя или "Интерактивный пользователь", чтобы приложение предполагало удостоверение текущего пользователя, выполнившего вход. Можно также указать строки "nt authority\localservice", "nt authority\networkservice" и "nt authority\system". Пароль по умолчанию для этих трех учетных записей — "" (пустая строка).
Access
Тип
По умолчанию
Минимальная система Windows 2000

 

Свойство Identity не включено для приложений библиотеки, которые выполняются в клиентском процессе.

Свойство Password должно быть задано одновременно с удостоверением перед использованием SaveChanges, так как пароль и удостоверение проверяются перед сохранением. Если пароль и удостоверение не синхронизированы, приложение не может быть запущено, пока администратор не сбросит их.

ImpersonationLevel

Ввод Значение
Описание Задает уровень олицетворения, используемый для вызовов других приложений.
Access ReadWrite
Тип Длинные возможные значения:COMAdminImpersonationAnonymous (1)COMAdminImpersonationIdentify (2)COMAdminImpersonationImpersonate (3)COMAdminImpersonationDelegate (4)
По умолчанию COMAdminImpersonationImpersonate (3)
Минимальная система Windows 2000

 

IsEnabled

Ввод Значение
Описание Если приложение или компонент COM+ отключены, isEnabled имеет значение False. Если приложение или компонент COM+ включено, isEnabled имеет значение True.
Access ReadWrite
Тип Bool
Значение по умолчанию True
Минимальная система Windows XP

 

IsSystem

Ввод Значение
Описание Определяет системные приложения COM+.
Access Только для чтения
Тип Bool
Значение по умолчанию Неверно
Минимальная система Windows 2000

 

MaxDumpCount

Ввод Значение
Описание Указывает максимальное количество файлов, создаваемых до перезаписи.
Access ReadWrite
Тип Long (1-200)
По умолчанию 5
Минимальная система Windows XP

 

Имя

Ввод Значение
Описание Имя приложения. Дополнительные пробелы в начале и конце строки удаляются. Это свойство возвращается при вызове метода свойства Name для объекта данной коллекции.
Access ReadWrite
Тип Строка
По умолчанию "Новое приложение"
Минимальная система Windows 2000

 

Примечание

Для приложений следует выбирать уникальные имена. Если несколько приложений создаются с одинаковым именем, это может помешать ссылаться на приложения по имени, что приведет к непредсказуемой работе.

 

Пароль

Ввод Значение
Описание Задает пароль, используемый серверным процессом для входа под удостоверением.
Access WriteOnly
Тип Строка
По умолчанию ""
Минимальная система Windows 2000

 

Пароль следует задать одновременно с удостоверением перед использованием SaveChanges, так как пароль и удостоверение проверяются перед сохранением. Если пароль и удостоверение не синхронизированы, приложение не может быть запущено, пока администратор не сбросит их.

QCAuthenticateMsgs

Ввод Значение
Описание Указывает, при каких обстоятельствах выполняется проверка подлинности запросов к приложению в очереди.
Access ReadWrite
Тип Длинные возможные значения:COMAdminQCMessageAuthenticateSecureApps (0)COMAdminQCMessageAuthenticateOff (1)COMAdminQCMessageAuthenticateOn (2)
По умолчанию COMAdminQCMessageAuthenticateSecureApps (0)
Минимальная система Windows XP

 

QCListenerMaxThreads

Ввод Значение
Описание Указывает максимальное количество параллельных потоков прослушивателя. Допустимый диапазон для этого свойства — от 0 до 1000. Для созданного приложения параметр является производным от алгоритма, используемого в настоящее время для определения количества потоков прослушивателя по умолчанию: в 16 раз больше ЦП на сервере.
Access ReadWrite
Тип Long (0–1000)
По умолчанию 0
Минимальная система Windows XP

 

Примечание

Это свойство также доступно с возможностью чтения и записи на вкладке Очередь средства администрирования Служб компонентов.

 

QueueListenerEnabled

Ввод Значение
Описание Указывает, включен ли прослушиватель компонентов в очереди для приложения. Если этот параметр включен, прослушиватель запускается при запуске приложения. Это свойство вступает в силу, только если для queuingEnabled задано значение True.
Access ReadWrite
Тип Bool
Значение по умолчанию Неверно
Минимальная система Windows 2000

 

QueuingEnabled

Ввод Значение
Описание Указывает, включена ли служба com+ очередей компонентов для приложения.
Access ReadWrite
Тип Bool
Значение по умолчанию Неверно
Минимальная система Windows 2000

 

RecycleActivationLimit

Ввод Значение
Описание Указывает максимальное число активаций настроенных объектов в приложении, которые необходимо принять перед перезапуском процесса. Число активаций по умолчанию равно 0.
Access ReadWrite
Тип Long (0–1048576)
По умолчанию 0
Минимальная система Windows XP

 

RecycleCallLimit

Ввод Значение
Описание Указывает максимальное количество вызовов, позволяющих настроенным объектам в приложении принимать до перезапуска процесса. Число вызовов по умолчанию равно 0.
Access ReadWrite
Тип Long (0–1048576)
По умолчанию 0
Минимальная система Windows XP

 

RecycleExpirationTimeout

Ввод Значение
Описание Указывает время (в минутах) для запуска переработанного процесса перед его завершением. Обратный отсчет начинается сразу после перезапуска процесса. Максимальное время ожидания истечения срока действия составляет 1440 минут (24 часа), а значение по умолчанию — 15 минут.
Access ReadWrite
Тип Long (1–1440)
По умолчанию 15
Минимальная система Windows XP

 

RecycleLifetimeLimit

Ввод Значение
Описание Указывает максимальное количество минут, в течение которых процесс может выполняться до его повторного использования. Максимальное время существования составляет 30240 минут (21 день), а значение по умолчанию — 0 минут.
Access ReadWrite
Тип Long (0–30240)
По умолчанию 0
Минимальная система Windows XP

 

RecycleMemoryLimit

Ввод Значение
Описание Указывает максимальный объем использования памяти (в килобайтах), разрешенный процессом перед его перезапуском. Если объем памяти процесса превышает указанное значение в течение периода, превышающего одну минуту, процесс перезапускается. Объем используемой памяти по умолчанию — 0 КБ.
Access ReadWrite
Тип Long (0–1048576)
По умолчанию 0
Минимальная система Windows XP

 

Репликация

Ввод Значение
Описание Указывает, можно ли реплицировать приложение.
Access ReadWrite
Тип Bool
По умолчанию True
Минимальная система Windows XP

 

RunForever

Ввод Значение
Описание Позволяет продолжить серверный процесс, если приложение бездействует. Если задано значение True, серверный процесс не завершает работу при выходе из строя. Если задано значение False, процесс завершает работу в соответствии со значением, заданным свойством ShutdownAfter. RunForever не включено для библиотек (внутрипроцессных) приложений.
Access ReadWrite
Тип Bool
Значение по умолчанию Неверно
Минимальная система Windows 2000

 

ServiceName

Ввод Значение
Описание Имя службы, соответствующее приложению, настроенного для запуска в качестве приложения-службы. Если это значение равно NULL, приложение не настроено для запуска как службы. В противном случае сведения о конфигурации для службы можно найти с помощью имени службы.
Access Только для чтения
Тип Строка
По умолчанию ""
Минимальная система Windows XP

 

Завершение работы После завершения работы

Ввод Значение
Описание Задает задержку перед завершением серверного процесса после его простоя. Задержка завершения работы составляет от 0 до 1440 минут (24 часа). Если параметру RunForever присвоено значение True, это свойство игнорируется. ShutdownAfter не включено для библиотек (внутрипроцессных) приложений.
Access ReadWrite
Тип Long (0–1440)
По умолчанию 3
Минимальная система Windows 2000

 

SoapActivated

Ввод Значение
Описание Указывает, предоставляется ли это приложение для использования через протокол SOAP.
Access ReadWrite
Тип Bool
Значение по умолчанию Неверно
Минимальная система Windows Server 2003

 

SoapBaseUrl

Ввод Значение
Описание Конечная точка URL-адреса, в которой это приложение предоставляется по протоколу SOAP.
Access ReadWrite
Тип Строка
По умолчанию ""
Минимальная система Windows Server 2003

 

SoapMailTo

Ввод Значение
Описание Адрес электронной почты, по которому это приложение предоставляется по протоколу SOAP.
Access ReadWrite
Тип Строка
По умолчанию ""
Минимальная система Windows Server 2003

 

SoapVRoot

Ввод Значение
Описание Виртуальный корневой каталог IIS, в котором находятся скрипты доступа, предоставляющие доступ к приложению по протоколу SOAP.
Access ReadWrite
Тип Строка
По умолчанию ""
Минимальная система Windows Server 2003

 

SRPEnabled

Ввод Значение
Описание Определяет политику ограничения программного обеспечения (SRP) для приложения. Если задано значение True, используется свойство SRPTrustLevel для приложения. Если задано значение False, используются политики ограничения программного обеспечения из локальных параметров безопасности. Локальные параметры безопасности управляются с помощью оснастки "Локальная политика безопасности" консоли управления (Майкрософт).
Access ReadWrite
Тип Bool
Значение по умолчанию Неверно
Минимальная система Windows XP

 

SRPTrustLevel

Ввод Значение
Описание Указывает уровень доверия к политике ограничения программного обеспечения (SRP) приложения. Это свойство используется, только если свойству SRPEnabled присвоено значение True. Уровень доверия SRP относится к уровню доверия, который вы готовы предоставить приложению. Уровень доверия неограниченного уровня SRP соответствует значению перечисления SAFER_LEVELID_FULLYTRUSTED, а уровень доверия запрещенного SRP соответствует значению перечисления SAFER_LEVELID_DISALLOWED. Перечисление для уровней доверия определено в Winsafer.h.
Access ReadWrite
Тип Длинные возможные значения:SAFER_LEVELID_DISALLOWED (0x0)SAFER_LEVELID_FULLYTRUSTED (0x40000)
По умолчанию SAFER_LEVELID_FULLYTRUSTED (0x40000)
Минимальная система Windows XP

 

Приложение, которому вы готовы доверять с неограниченным доступом, должно иметь самые строгие требования безопасности. Приложения, которые являются неограниченными, могут загружать только неограниченные компоненты, в то время как запрещенные приложения не будут разрешены к запуску и, следовательно, не могут загружать какие-либо компоненты.

См. также раздел

Коллекции администрирования COM+