Coleção de aplicativos
Contém um objeto para cada aplicativo COM+ instalado no computador local. As propriedades expostas por esses objetos contêm todas as configurações feitas no nível do aplicativo.
Você define propriedades para componentes em um aplicativo usando a coleção Components relacionada. Você atribui funções a um aplicativo usando a coleção Roles relacionada.
Para instalar componentes em um aplicativo, use métodos no objeto COMAdminCatalog . Para instalar um aplicativo de um arquivo ou para desligar ou exportar um aplicativo, use também métodos no objeto COMAdminCatalog . Caso contrário, para criar um novo aplicativo, você pode adicionar um objeto à coleção Applications .
Esta coleção dá suporte aos métodos Add e Remove do objeto COMAdminCatalogCollection .
Membros
A coleção Applications herda da interface IUnknown , mas não tem membros adicionais.
Coleções relacionadas
Você pode navegar desta coleção para qualquer uma das seguintes coleções:
- ApplicationInstances
- Componentes
- ErrorInfo
- LegacyComponents
- Propertyinfo
- RelatedCollectionInfo
- Funções
Você pode navegar até esta coleção das seguintes coleções:
Propriedades
As propriedades a seguir são compatíveis com o objeto COMAdminCatalogObject dentro da coleção:
- 3GigSupportEnabled
- AccessChecksLevel
- Ativação
- ApplicationAccessChecksEnabled
- Applicationdirectory
- ApplicationProxy
- ApplicationProxyServerName
- AppPartitionID
- Autenticação
- AuthenticationCapability
- Mutável
- CommandLine
- ConcurrentApps
- CreatedBy
- CRMEnabled
- CRMLogFile
- Excluível
- Descrição
- DumpEnabled
- DumpOnException
- DumpOnFailfast
- DumpPath
- EventsEnabled
- ID
- Identidade
- ImpersonationLevel
- IsEnabled
- IsSystem
- MaxDumpCount
- Nome
- Senha
- QCAuthenticateMsgs
- QCListenerMaxThreads
- Queuelistenerenabled
- QueuingEnabled
- RecycleActivationLimit
- RecycleCallLimit
- RecycleExpirationTimeout
- RecycleLifetimeLimit
- RecycleMemoryLimit
- Replicável
- RunForever
- ServiceName
- ShutdownAfter
- SoapActivated
- SoapBaseUrl
- SoapMailTo
- SoapVRoot
- SRPEnabled
- SRPTrustLevel
3GigSupportEnabled
| Entrada | Valor |
|---|---|
| Descrição | Indica se o aplicativo pode usar 3 GB de memória em seu processo. Se isso não estiver habilitado, o aplicativo poderá usar apenas 2 GB de memória. |
| Access | ReadWrite |
| Type | Bool |
| Padrão | Falso |
| Sistema mínimo | Windows 2000 |
AccessChecksLevel
| Entrada | Valor |
|---|---|
| Descrição | Indica se as verificações de acesso são executadas apenas no nível do processo ou no nível do processo e do componente. É recomendável que você use as constantes na enumeração e não os valores numéricos. |
| Access | ReadWrite |
| Type | Valores Long Possible: COMAdminAccessChecksApplicationLevel (0) COMAdminAccessChecksApplicationComponentLevel (1) |
| Padrão | COMAdminAccessChecksApplicationComponentLevel (1) |
| Sistema mínimo | Windows 2000 |
Ativação
| Entrada | Valor |
|---|---|
| Descrição | A ativação local indica que os objetos dentro do aplicativo são executados em um processo de servidor local dedicado (aplicativo de servidor). A ativação em processo indica que os objetos são executados no processo do criador (aplicativo de biblioteca). |
| Access | ReadWrite |
| Type | Valores Long Possible:COMAdminActivationInproc (0)COMAdminActivationLocal (1) |
| Padrão | COMAdminActivationLocal (1) |
| Sistema mínimo | Windows 2000 |
ApplicationAccessChecksEnabled
| Entrada | Valor |
|---|---|
| Descrição | Indica se as verificações de acesso são executadas para o aplicativo quando os clientes fazem chamadas para ele. |
| Access | ReadWrite |
| Type | Bool |
| Padrão | True |
| Sistema mínimo | Windows 2000 |
Applicationdirectory
| Entrada | Valor |
|---|---|
| Descrição | O caminho completo para o aplicativo. Essas informações são necessárias quando você configura assemblies SxS (lado a lado). Assemblies SxS (lado a lado) permitem que aplicativos ASP especifiquem qual versão de uma DLL do sistema compatível com SxS usar, como MSVCRT, MSXML, COMCTL, GDIPLUS e assim por diante. Por exemplo, se o aplicativo ASP depender do MSVCRT versão 2.0, você poderá garantir que seu aplicativo ainda use o MSVCRT versão 2.0 mesmo depois que os service packs forem aplicados ao servidor. Qualquer nova versão do MSVCRT ainda está instalada no computador, mas a versão 2.0 permanece e é usada pelo aplicativo. As DLLs compatíveis com SxS são armazenadas em %WINDIR%\WinSxS. |
| Access | ReadWrite |
| Type | String |
| Padrão | "" |
| Sistema mínimo | Windows XP |
Observação
Somente uma versão de uma DLL do sistema pode ser usada em qualquer pool de aplicativos, mesmo que esse recurso seja configurável no nível do aplicativo. Por exemplo, se o aplicativo App1 usa MSVCRT, versão 2.5 e aplicativo App2 usa MSVCRT, versão 2.4, app1 e App2 não devem estar no mesmo pool de aplicativos. Se estiverem, o aplicativo carregado primeiro terá sua versão do MSVCRT carregada e o outro aplicativo será forçado a usá-lo até que os aplicativos sejam descarregados.
Para obter mais informações, consulte "Assemblies lado a lado" em Alterações nos Serviços COM+ no IIS 6.0.
ApplicationProxy
| Entrada | Valor |
|---|---|
| Descrição | Indica se o aplicativo é um proxy de aplicativo. |
| Access | ReadOnly |
| Type | Bool |
| Padrão | Falso |
| Sistema mínimo | Windows 2000 |
ApplicationProxyServerName
| Entrada | Valor |
|---|---|
| Descrição | Um nome de servidor remoto usado ao exportar o proxy de aplicativo. É esse nome de servidor para o qual o proxy de aplicativo aponta quando ele é instalado em um computador cliente. |
| Access | ReadWrite |
| Type | String |
| Padrão | "" |
| Sistema mínimo | Windows 2000 |
AppPartitionID
| Entrada | Valor |
|---|---|
| Descrição | Um GUID que representa a ID de partição do aplicativo. |
| Access | ReadOnly |
| Type | String |
| Padrão | <Gerado> |
| Sistema mínimo | Windows Server 2003 |
Autenticação
| Entrada | Valor |
|---|---|
| Descrição | Define o nível de autenticação para chamadas, com valores correspondentes às configurações de autenticação RPC (Chamada de Procedimento Remoto). Quando COMAdminAuthenticationDefault é escolhido, a configuração na propriedade DefaultAuthenticationLevel dentro da coleção LocalComputer é usada. |
| Access | ReadWrite |
| Type | Valores Long Possible:COMAdminAuthenticationDefault (0)COMAdminAuthenticationNone (1) COMAdminAuthenticationConnect (2)COMAdminAuthenticationCall (3)COMAdminAuthenticationPacket (4)COMAdminAuthenticationIntegrity (5)COMAdminAuthenticationPrivacy (6) |
| Padrão | COMAdminAuthenticationPacket (4) |
| Sistema mínimo | Windows 2000 |
Observação
Para aplicativos de biblioteca (em processo), as únicas configurações válidas aqui são COMAdminAuthenticationDefault e COMAdminAuthenticationNone . É recomendável que você use as constantes na enumeração e não os valores numéricos.
AuthenticationCapability
| Entrada | Valor |
|---|---|
| Descrição | Determina qual identidade é apresentada quando as chamadas são representadas. |
| Access | ReadWrite |
| Type | Long Possible values:COMAdminAuthenticationCapabilitiesNone (0x0)COMAdminAuthenticationCapabilitiesSecureReference (0x2)COMAdminAuthenticationCapabilitiesStaticCloaking (0x20)COMAdminAuthenticationCapabilitiesDynamicCloaking (0x40) |
| Padrão | COMAdminAuthenticationCapabilitiesDynamicCloaking (0x40) |
| Sistema mínimo | Windows 2000 |
Mutável
| Entrada | Valor |
|---|---|
| Descrição | Determina se as alterações nas configurações do aplicativo ou nos de seus componentes são permitidas, seja programaticamente ou por meio da ferramenta de administração dos Serviços de Componentes. |
| Access | ReadWrite |
| Type | Bool |
| Padrão | True |
| Sistema mínimo | Windows 2000 |
CommandLine
| Entrada | Valor |
|---|---|
| Descrição | Uma cadeia de caracteres de linha de comando para uso na depuração. O aplicativo pode ser iniciado em um depurador com a linha de comando especificada. |
| Access | ReadWrite |
| Type | String |
| Padrão | "" |
| Sistema mínimo | Windows 2000 |
ConcurrentApps
| Entrada | Valor |
|---|---|
| Descrição | Especifica o número máximo de aplicativos em pool que podem ser executados simultaneamente. |
| Access | ReadWrite |
| Type | Long (1-1048576) |
| Padrão | 1 |
| Sistema mínimo | Windows XP |
CreatedBy
| Entrada | Valor |
|---|---|
| Descrição | Cadeia de caracteres informativa para descrever quem criou o aplicativo. |
| Access | ReadWrite |
| Type | String |
| Padrão | "" |
| Sistema mínimo | Windows 2000 |
CRMEnabled
| Entrada | Valor |
|---|---|
| Descrição | Determina se o Resource Manager de Compensação está habilitado. |
| Access | ReadWrite |
| Type | Bool |
| Padrão | Falso |
| Sistema mínimo | Windows 2000 |
CRMLogFile
| Entrada | Valor |
|---|---|
| Descrição | Nome e caminho do arquivo para manter o log para o CRM (gerenciador de recursos de compensação). |
| Access | ReadWrite |
| Type | String |
| Padrão | "" |
| Sistema mínimo | Windows 2000 |
Excluível
| Entrada | Valor |
|---|---|
| Descrição | Define se o aplicativo pode ser excluído, seja programaticamente ou por meio da ferramenta de administração dos Serviços de Componentes. |
| Access | ReadWrite |
| Type | Bool |
| Padrão | True |
| Sistema mínimo | Windows 2000 |
Descrição
| Entrada | Valor |
|---|---|
| Descrição | Descreve o aplicativo. |
| Access | ReadWrite |
| Type | String |
| Padrão | "" |
| Sistema mínimo | Windows 2000 |
DumpEnabled
| Entrada | Valor |
|---|---|
| Descrição | Habilita o despejo do estado de um aplicativo COM+ no momento da falha em um diretório designado. |
| Access | ReadWrite |
| Type | Bool |
| Padrão | Falso |
| Sistema mínimo | Windows XP |
Observação
A partir do Windows Server 2003, somente os administradores têm privilégios de acesso de leitura para os arquivos de despejo COM+.
DumpOnException
| Entrada | Valor |
|---|---|
| Descrição | Habilita o despejo do estado de um aplicativo COM+ quando o aplicativo causa uma exceção sem tratamento e é encerrado pelo runtime COM+. |
| Access | ReadWrite |
| Type | Bool |
| Padrão | Falso |
| Sistema mínimo | Windows XP |
DumpOnFailfast
| Entrada | Valor |
|---|---|
| Descrição | Habilita o despejo do estado de um aplicativo COM+ quando o aplicativo falha. |
| Access | ReadWrite |
| Type | Bool |
| Padrão | Falso |
| Sistema mínimo | Windows XP |
DumpPath
| Entrada | Valor |
|---|---|
| Descrição | O caminho do diretório no qual os arquivos de despejo são salvos. |
| Access | ReadWrite |
| Type | String |
| Padrão | "%systemroot%\system32\com\dmp" |
| Sistema mínimo | Windows XP |
Observação
A partir do Windows Server 2003, somente os administradores têm privilégios de acesso de leitura para os arquivos de despejo COM+.
EventsEnabled
| Entrada | Valor |
|---|---|
| Descrição | Indica se os eventos estão habilitados para o aplicativo. |
| Access | ReadWrite |
| Type | Bool |
| Padrão | True |
| Sistema mínimo | Windows 2000 |
ID
| Entrada | Valor |
|---|---|
| Descrição | Um GUID que representa o aplicativo. Essa propriedade é retornada quando o método de propriedade Key é chamado em um objeto dessa coleção. |
| Access | WriteOnce |
| Type | String |
| Padrão | <Gerado> |
| Sistema mínimo | Windows 2000 |
Identidade
| Entrada | Valor |
|---|---|
| Descrição | Define a identidade do processo do servidor para o aplicativo. Especifique uma conta de usuário válida ou "Usuário Interativo" para que o aplicativo assuma a identidade do usuário conectado atual. Você também pode especificar as cadeias de caracteres "nt authority\localservice", "nt authority\networkservice" e "nt authority\system". A senha padrão para essas três contas é "" (cadeia de caracteres vazia). |
| Access | |
| Type | |
| Padrão | |
| Sistema mínimo | Windows 2000 |
A propriedade Identity não está habilitada para aplicativos de biblioteca, que são executados no processo do cliente.
A propriedade Password deve ser definida ao mesmo tempo que Identity, antes de usar SaveChanges, porque a senha e a identidade são validadas antes de serem salvas. Se a senha e a identidade ficarem fora de sincronia, o aplicativo não poderá ser iniciado até que sejam redefinidos por um administrador.
ImpersonationLevel
| Entrada | Valor |
|---|---|
| Descrição | Define o nível de representação usado para chamadas feitas a outros aplicativos. |
| Access | ReadWrite |
| Type | Valores Long Possible:COMAdminImpersonationAnonymous (1)COMAdminImpersonationIdentify (2)COMAdminImpersonationImpersonate (3)COMAdminImpersonationDelegate (4) |
| Padrão | COMAdminImpersonationImpersonate (3) |
| Sistema mínimo | Windows 2000 |
IsEnabled
| Entrada | Valor |
|---|---|
| Descrição | Se o aplicativo ou componente COM+ estiver desabilitado, IsEnabled será False. Se o aplicativo ou componente COM+ estiver habilitado, IsEnabled será True. |
| Access | ReadWrite |
| Type | Bool |
| Padrão | True |
| Sistema mínimo | Windows XP |
IsSystem
| Entrada | Valor |
|---|---|
| Descrição | Identifica aplicativos do sistema COM+. |
| Access | ReadOnly |
| Type | Bool |
| Padrão | Falso |
| Sistema mínimo | Windows 2000 |
MaxDumpCount
| Entrada | Valor |
|---|---|
| Descrição | Indica o número máximo de arquivos a serem gerados antes da substituição ocorrer. |
| Access | ReadWrite |
| Type | Long (1-200) |
| Padrão | 5 |
| Sistema mínimo | Windows XP |
Nome
| Entrada | Valor |
|---|---|
| Descrição | O nome do aplicativo. Espaços extras no início e no final da cadeia de caracteres são removidos. Essa propriedade é retornada quando o método da propriedade Name é chamado em um objeto dessa coleção. |
| Access | ReadWrite |
| Type | String |
| Padrão | "Novo Aplicativo" |
| Sistema mínimo | Windows 2000 |
Observação
Nomes exclusivos devem ser escolhidos para aplicativos. Se vários aplicativos forem criados com o mesmo nome, ele poderá interferir na referência aos aplicativos pelo nome, resultando em um comportamento imprevisível.
Senha
| Entrada | Valor |
|---|---|
| Descrição | Define a senha usada pelo processo do servidor para fazer logon na identidade. |
| Access | WriteOnly |
| Type | String |
| Padrão | "" |
| Sistema mínimo | Windows 2000 |
A senha deve ser definida ao mesmo tempo que a Identidade, antes de usar SaveChanges, porque a senha e a identidade são validadas antes de serem salvas. Se a senha e a identidade ficarem fora de sincronia, o aplicativo não poderá ser iniciado até que eles sejam redefinidos por um administrador.
QCAuthenticateMsgs
| Entrada | Valor |
|---|---|
| Descrição | Indica em que circunstâncias as solicitações enfileiradas para um aplicativo são autenticadas. |
| Access | ReadWrite |
| Type | Valores Long Possible:COMAdminQCMessageAuthenticateSecureApps (0)COMAdminQCMessageAuthenticateOff (1)COMAdminQCMessageAuthenticateOn (2) |
| Padrão | COMAdminQCMessageAuthenticateSecureApps (0) |
| Sistema mínimo | Windows XP |
QCListenerMaxThreads
| Entrada | Valor |
|---|---|
| Descrição | Indica o número máximo de threads de ouvinte simultâneos. O intervalo válido para essa propriedade é de 0 a 1000. Para um aplicativo recém-criado, a configuração é derivada do algoritmo usado atualmente para determinar o número padrão de threads do ouvinte: 16 vezes o número de CPUs no servidor. |
| Access | ReadWrite |
| Type | Long (0-1000) |
| Padrão | 0 |
| Sistema mínimo | Windows XP |
Observação
Essa propriedade também está disponível com a funcionalidade de leitura/gravação na guia Enfileiramento da ferramenta administrativa dos Serviços de Componentes.
Queuelistenerenabled
| Entrada | Valor |
|---|---|
| Descrição | Indica se o ouvinte de componentes enfileirados está habilitado para o aplicativo. Se habilitado, o ouvinte será iniciado quando o aplicativo for iniciado. Essa propriedade entrará em vigor somente se QueuingEnabled estiver definido como True. |
| Access | ReadWrite |
| Type | Bool |
| Padrão | Falso |
| Sistema mínimo | Windows 2000 |
QueuingEnabled
| Entrada | Valor |
|---|---|
| Descrição | Indica se o serviço componentes enfileirados COM+ está habilitado para o aplicativo. |
| Access | ReadWrite |
| Type | Bool |
| Padrão | Falso |
| Sistema mínimo | Windows 2000 |
RecycleActivationLimit
| Entrada | Valor |
|---|---|
| Descrição | Indica o número máximo de ativações de objetos configurados no aplicativo a serem aceitas antes de reciclar o processo. O número padrão de ativações é 0. |
| Access | ReadWrite |
| Type | Long (0-1048576) |
| Padrão | 0 |
| Sistema mínimo | Windows XP |
RecycleCallLimit
| Entrada | Valor |
|---|---|
| Descrição | Indica o número máximo de chamadas para permitir que objetos configurados no aplicativo aceitem antes de reciclar o processo. O número padrão de chamadas é 0. |
| Access | ReadWrite |
| Type | Long (0-1048576) |
| Padrão | 0 |
| Sistema mínimo | Windows XP |
RecycleExpirationTimeout
| Entrada | Valor |
|---|---|
| Descrição | Indica a quantidade de tempo (em minutos) para permitir que um processo reciclado seja executado antes de desligá-lo. A contagem regressiva começa imediatamente após o processo ser reciclado. O tempo limite máximo de expiração é de 1440 minutos (24 horas) e o padrão é 15 minutos. |
| Access | ReadWrite |
| Type | Long (1-1440) |
| Padrão | 15 |
| Sistema mínimo | Windows XP |
RecycleLifetimeLimit
| Entrada | Valor |
|---|---|
| Descrição | Indica o número máximo de minutos para permitir que um processo seja executado antes de reciclá-lo. O limite máximo de tempo de vida é de 30240 minutos (21 dias) e o padrão é 0 minutos. |
| Access | ReadWrite |
| Type | Long (0-30240) |
| Padrão | 0 |
| Sistema mínimo | Windows XP |
RecycleMemoryLimit
| Entrada | Valor |
|---|---|
| Descrição | Indica que a quantidade máxima de uso de memória (em quilobytes) permitiu um processo antes de ser reciclado. Se o uso da memória do processo exceder o número especificado por um período maior que um minuto, o processo será reciclado. A quantidade padrão de uso de memória é de 0 KB. |
| Access | ReadWrite |
| Type | Long (0-1048576) |
| Padrão | 0 |
| Sistema mínimo | Windows XP |
Replicável
| Entrada | Valor |
|---|---|
| Descrição | Indica se o aplicativo pode ser replicado. |
| Access | ReadWrite |
| Type | Bool |
| Padrão | True |
| Sistema mínimo | Windows XP |
RunForever
| Entrada | Valor |
|---|---|
| Descrição | Permite que um processo de servidor continue se um aplicativo estiver ocioso. Se definido como True, o processo do servidor não será desligado quando deixado ocioso. Se definido como False, o processo será desligado de acordo com o valor definido pela propriedade ShutdownAfter. RunForever não está habilitado para aplicativos de biblioteca (em processo). |
| Access | ReadWrite |
| Type | Bool |
| Padrão | Falso |
| Sistema mínimo | Windows 2000 |
ServiceName
| Entrada | Valor |
|---|---|
| Descrição | O nome do serviço correspondente ao aplicativo configurado para ser executado como um aplicativo de serviço. Se esse valor for NULL, o aplicativo não será configurado para ser executado como um serviço. Caso contrário, as informações de configuração do serviço podem ser encontradas usando o nome do serviço. |
| Access | ReadOnly |
| Type | String |
| Padrão | "" |
| Sistema mínimo | Windows XP |
ShutdownAfter
| Entrada | Valor |
|---|---|
| Descrição | Define o atraso antes de desligar um processo de servidor depois que ele fica ocioso. A latência de desligamento varia de 0 a 1440 minutos (24 horas). Se RunForever estiver definido como True, essa propriedade será ignorada. ShutdownAfter não está habilitado para aplicativos de biblioteca (em processo). |
| Access | ReadWrite |
| Type | Long (0-1440) |
| Padrão | 3 |
| Sistema mínimo | Windows 2000 |
SoapActivated
| Entrada | Valor |
|---|---|
| Descrição | Indica se esse aplicativo é exposto para consumo por meio do protocolo SOAP. |
| Access | ReadWrite |
| Type | Bool |
| Padrão | Falso |
| Sistema mínimo | Windows Server 2003 |
SoapBaseUrl
| Entrada | Valor |
|---|---|
| Descrição | O ponto de extremidade de URL no qual esse aplicativo é exposto por meio do protocolo SOAP. |
| Access | ReadWrite |
| Type | String |
| Padrão | "" |
| Sistema mínimo | Windows Server 2003 |
SoapMailTo
| Entrada | Valor |
|---|---|
| Descrição | O endereço de email no qual esse aplicativo é exposto por meio do protocolo SOAP. |
| Access | ReadWrite |
| Type | String |
| Padrão | "" |
| Sistema mínimo | Windows Server 2003 |
SoapVRoot
| Entrada | Valor |
|---|---|
| Descrição | O diretório raiz virtual do IIS no qual residem os scripts de acesso que expõem o aplicativo por meio do protocolo SOAP. |
| Access | ReadWrite |
| Type | String |
| Padrão | "" |
| Sistema mínimo | Windows Server 2003 |
SRPEnabled
| Entrada | Valor |
|---|---|
| Descrição | Determina a SRP (política de restrição de software) para o aplicativo. Se definido como True, a propriedade SRPTrustLevel para o aplicativo será usada. Se definido como False, as políticas de restrição de software das configurações de segurança local serão usadas. As configurações de segurança local são controladas por meio do snap-in Política de Segurança Local do Console de Gerenciamento da Microsoft. |
| Access | ReadWrite |
| Type | Bool |
| Padrão | Falso |
| Sistema mínimo | Windows XP |
SRPTrustLevel
| Entrada | Valor |
|---|---|
| Descrição | Indica o nível de confiança da política de restrição de software (SRP) do aplicativo. Essa propriedade será usada somente se a propriedade SRPEnabled estiver definida como True. O nível de confiança srp refere-se ao nível de confiança que você está disposto a dar a um aplicativo. Um nível de confiança SRP irrestrito corresponde ao valor de enumeração SAFER_LEVELID_FULLYTRUSTED, enquanto um nível de confiança SRP não permitido corresponde ao valor de enumeração SAFER_LEVELID_DISALLOWED. A enumeração para os níveis de confiança é definida em Winsafer.h. |
| Access | ReadWrite |
| Type | Valores long possible:SAFER_LEVELID_DISALLOWED (0x0)SAFER_LEVELID_FULLYTRUSTED (0x40000) |
| Padrão | SAFER_LEVELID_FULLYTRUSTED (0x40000) |
| Sistema mínimo | Windows XP |
Um aplicativo em que você está disposto a confiar com acesso irrestrito deve ter a segurança mais rigorosa anexada a ele. Aplicativos irrestritos podem carregar apenas componentes irrestritos, enquanto os aplicativos não permitidos não poderão ser executados e, portanto, não poderão carregar nenhum componente.
Confira também