Коллекция Applications
Содержит объект для каждого приложения COM+, установленного на локальном компьютере. Свойства, предоставляемые этими объектами, содержат все параметры, сделанные на уровне приложения.
Свойства компонентов в приложении задаются с помощью связанной коллекции Components . Роли назначаются приложению с помощью связанной коллекции ролей .
Чтобы установить компоненты в приложение, используйте методы в объекте COMAdminCatalog . Чтобы установить приложение из файла, завершить работу или экспортировать приложение, также используйте методы в объекте COMAdminCatalog . В противном случае для создания нового приложения можно добавить объект в коллекцию Applications .
Эта коллекция поддерживает методы Add и Remove объекта COMAdminCatalogCollection .
Элементы
Коллекция Applications наследуется от интерфейса IUnknown , но не имеет дополнительных членов.
Связанные коллекции
Вы можете перейти из этой коллекции в любую из следующих коллекций:
- ApplicationInstances
- Компоненты
- ErrorInfo
- Устаревшие компоненты
- Propertyinfo
- RelatedCollectionInfo
- Роли
Вы можете перейти к этой коллекции из следующих коллекций:
Свойства
Следующие свойства поддерживаются объектом COMAdminCatalogObject в коллекции:
- 3GigSupportEnabled
- AccessChecksLevel
- Активация
- ApplicationAccessChecksEnabled
- ApplicationDirectory
- ApplicationProxy
- ApplicationProxyServerName
- AppPartitionID
- Аутентификация
- AuthenticationCapability
- Поддержка изменений
- CommandLine
- ConcurrentApps
- CreatedBy
- CRMEnabled
- CRMLogFile
- Удаляемый
- Описание
- DumpEnabled
- DumpOnException
- DumpOnFailfast
- DumpPath
- EventsEnabled
- Идентификатор
- Удостоверение
- ImpersonationLevel
- IsEnabled
- IsSystem
- MaxDumpCount
- имя;
- Пароль
- QCAuthenticateMsgs
- QCListenerMaxThreads
- QueueListenerEnabled
- QueuingEnabled
- RecycleActivationLimit
- RecycleCallLimit
- RecycleExpirationTimeout
- RecycleLifetimeLimit
- RecycleMemoryLimit
- Репликация
- RunForever
- ServiceName
- Завершение работы После завершения работы
- SoapActivated
- SoapBaseUrl
- SoapMailTo
- SoapVRoot
- SRPEnabled
- SRPTrustLevel
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 |
Приложение, которому вы готовы доверять с неограниченным доступом, должно иметь самые строгие требования безопасности. Приложения, которые являются неограниченными, могут загружать только неограниченные компоненты, в то время как запрещенные приложения не будут разрешены к запуску и, следовательно, не могут загружать какие-либо компоненты.
См. также раздел