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.

Você pode navegar desta coleção para qualquer uma das seguintes coleçõ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

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

Coleções de administração COM+