Colección de aplicaciones

  • Artículo

Contiene un objeto para cada aplicación COM+ instalada en el equipo local. Las propiedades expuestas por estos objetos contienen todas las configuraciones realizadas en el nivel de aplicación.

Las propiedades de los componentes de una aplicación se establecen mediante la colección Components relacionada. Los roles se asignan a una aplicación mediante la colección Roles relacionada.

Para instalar componentes en una aplicación, use métodos en el objeto COMAdminCatalog . Para instalar una aplicación desde un archivo o para apagar o exportar una aplicación, use también métodos en el objeto COMAdminCatalog . De lo contrario, para crear una nueva aplicación, puede agregar un objeto a la colección Applications .

Esta colección admite los métodos Add y Remove del objeto COMAdminCatalogCollection .

Miembros

La colección Applications hereda de la interfaz IUnknown , pero no tiene miembros adicionales.

Puede navegar desde esta colección a cualquiera de las colecciones siguientes:

Puede ir a esta colección desde las siguientes colecciones:

Propiedades

El objeto COMAdminCatalogObject admite las siguientes propiedades dentro de la colección:

3GigSupportEnabled

Entrada Valor
Descripción Indica si la aplicación puede usar 3 GB de memoria en su proceso. Si esto no está habilitado, la aplicación solo puede usar 2 GB de memoria.
Access ReadWrite
Tipo Bool
Valor predeterminado False
Sistema mínimo Windows 2000

 

AccessChecksLevel

Entrada Valor
Descripción Indica si las comprobaciones de acceso se realizan solo en el nivel de proceso o en el nivel de proceso y componente. Se recomienda usar las constantes de la enumeración y no los valores numéricos.
Access ReadWrite
Tipo Valores long Posibles: COMAdminAccessChecksApplicationLevel (0) COMAdminAccessChecksApplicationComponentLevel (1)
Default COMAdminAccessChecksApplicationComponentLevel (1)
Sistema mínimo Windows 2000

 

Activación

Entrada Valor
Descripción La activación local indica que los objetos dentro de la aplicación se ejecutan dentro de un proceso de servidor local dedicado (aplicación de servidor). La activación en proceso indica que los objetos se ejecutan en el proceso del creador (aplicación de biblioteca).
Access ReadWrite
Tipo Valores posibles largos:COMAdminActivationInproc (0)COMAdminActivationLocal (1)
Default COMAdminActivationLocal (1)
Sistema mínimo Windows 2000

 

ApplicationAccessChecksEnabled

Entrada Valor
Descripción Indica si se realizan comprobaciones de acceso para la aplicación cuando los clientes realizan llamadas a ella.
Access ReadWrite
Tipo Bool
Default True
Sistema mínimo Windows 2000

 

ApplicationDirectory

Entrada Valor
Descripción Ruta de acceso completa a la aplicación. Esta información es necesaria al configurar ensamblados en paralelo (SxS). Los ensamblados en paralelo (SxS) permiten a las aplicaciones ASP especificar qué versión de una DLL del sistema compatible con SxS se va a usar, como MSVCRT, MSXML, COMCTL, GDIPLUS, etc. Por ejemplo, si la aplicación ASP se basa en la versión 2.0 de MSVCRT, puede asegurarse de que la aplicación siga usando la versión 2.0 de MSVCRT incluso después de aplicar service packs al servidor. Cualquier nueva versión de MSVCRT todavía está instalada en el equipo, pero la versión 2.0 permanece y la usa la aplicación. Los archivos DLL compatibles con SxS se almacenan en %WINDIR%\WinSxS.
Access ReadWrite
Tipo String
Predeterminado ""
Sistema mínimo Windows XP

 

Nota

Solo se puede usar una versión de un archivo DLL del sistema en cualquier grupo de aplicaciones, aunque esta característica se pueda configurar en el nivel de aplicación. Por ejemplo, si la aplicación App1 usa MSVCRT, la versión 2.5 y la aplicación App2 usa MSVCRT, versión 2.4, App1 y App2 no deben estar en el mismo grupo de aplicaciones. Si son, la aplicación que se carga primero tiene cargada su versión de MSVCRT y la otra aplicación se ve obligada a usarla hasta que se descarguen las aplicaciones.

 

Para obtener más información, vea "Ensamblados en paralelo" en Cambios en servicios COM+ en IIS 6.0.

ApplicationProxy

Entrada Valor
Descripción Indica si la aplicación es un proxy de aplicación.
Access ReadOnly
Tipo Bool
Valor predeterminado False
Sistema mínimo Windows 2000

 

ApplicationProxyServerName

Entrada Valor
Descripción Un nombre de servidor remoto que se usa al exportar el proxy de aplicación. Es este nombre de servidor al que apunta el proxy de aplicación cuando está instalado en un equipo cliente.
Access ReadWrite
Tipo String
Predeterminado ""
Sistema mínimo Windows 2000

 

AppPartitionID

Entrada Valor
Descripción GUID que representa el identificador de partición de la aplicación.
Access ReadOnly
Tipo String
Predeterminado <Generado>
Sistema mínimo Windows Server 2003

 

Authentication

Entrada Valor
Descripción Establece el nivel de autenticación de las llamadas, con los valores correspondientes a la configuración de autenticación de llamada a procedimiento remoto (RPC). Cuando se elige COMAdminAuthenticationDefault, se usa el valor de la propiedad DefaultAuthenticationLevel dentro de la colección LocalComputer .
Access ReadWrite
Tipo Valores posibles largos:COMAdminAuthenticationDefault (0)COMAdminAuthenticationNone (1) COMAdminAuthenticationConnect (2)COMAdminAuthenticationCall (3)COMAdminAuthenticationPacket (4)COMAdminAuthenticationIntegrity (5)COMAdminAuthenticationPrivacy (6)
Default COMAdminAuthenticationPacket (4)
Sistema mínimo Windows 2000

 

Nota

En el caso de las aplicaciones de biblioteca (en proceso), la única configuración válida aquí es COMAdminAuthenticationDefault y COMAdminAuthenticationNone . Se recomienda usar las constantes de la enumeración y no los valores numéricos.

 

AuthenticationCapability

Entrada Valor
Descripción Determina qué identidad se presenta cuando se suplantan las llamadas.
Access ReadWrite
Tipo Valores posibles largos:COMAdminAuthenticationCapabilitiesNone (0x0)COMAdminAuthenticationCapabilitiesSecureReference (0x2)COMAdminAuthenticationCapabilitiesStaticCloaking (0x20)COMAdminAuthenticationCapabilitiesDynamicCloaking (0x40)
Default COMAdminAuthenticationCapabilitiesDynamicCloaking (0x40)
Sistema mínimo Windows 2000

 

Cambiable

Entrada Valor
Descripción Determina si se permiten cambios en la configuración de la aplicación o en los de sus componentes, ya sea mediante programación o a través de la herramienta de administración servicios de componentes.
Access ReadWrite
Tipo Bool
Default True
Sistema mínimo Windows 2000

 

CommandLine

Entrada Valor
Descripción Cadena de línea de comandos para su uso en la depuración. La aplicación se puede iniciar en un depurador con la línea de comandos especificada.
Access ReadWrite
Tipo String
Predeterminado ""
Sistema mínimo Windows 2000

 

ConcurrentApps

Entrada Valor
Descripción Especifica el número máximo de aplicaciones agrupables que se pueden ejecutar simultáneamente.
Access ReadWrite
Tipo Long (1-1048576)
Default 1
Sistema mínimo Windows XP

 

CreatedBy

Entrada Valor
Descripción Cadena informativa para describir quién creó la aplicación.
Access ReadWrite
Tipo String
Predeterminado ""
Sistema mínimo Windows 2000

 

CRMEnabled

Entrada Valor
Descripción Determina si la Resource Manager de compensación está habilitada.
Access ReadWrite
Tipo Bool
Valor predeterminado False
Sistema mínimo Windows 2000

 

CRMLogFile

Entrada Valor
Descripción Nombre y ruta de acceso del archivo para mantener el registro para el administrador de recursos de compensación (CRM).
Access ReadWrite
Tipo String
Predeterminado ""
Sistema mínimo Windows 2000

 

Eliminable

Entrada Valor
Descripción Establece si la aplicación se puede eliminar, ya sea mediante programación o a través de la herramienta de administración servicios de componentes.
Access ReadWrite
Tipo Bool
Default True
Sistema mínimo Windows 2000

 

Descripción

Entrada Valor
Descripción Describe la aplicación.
Access ReadWrite
Tipo String
Predeterminado ""
Sistema mínimo Windows 2000

 

DumpEnabled

Entrada Valor
Descripción Habilita el volcado de memoria del estado de una aplicación COM+ en el momento de error en un directorio designado.
Access ReadWrite
Tipo Bool
Valor predeterminado False
Sistema mínimo Windows XP

 

Nota

A partir de Windows Server 2003, solo los administradores tienen privilegios de acceso de lectura a los archivos de volcado com+.

 

DumpOnException

Entrada Valor
Descripción Habilita el volcado del estado de una aplicación COM+ cuando la aplicación produce una excepción no controlada y finaliza el tiempo de ejecución de COM+.
Access ReadWrite
Tipo Bool
Valor predeterminado False
Sistema mínimo Windows XP

 

DumpOnFaiheld

Entrada Valor
Descripción Habilita el volcado del estado de una aplicación COM+ cuando se produce un error en la aplicación.
Access ReadWrite
Tipo Bool
Valor predeterminado False
Sistema mínimo Windows XP

 

DumpPath

Entrada Valor
Descripción Ruta de acceso del directorio en el que se guardan los archivos de volcado.
Access ReadWrite
Tipo String
Predeterminado "%systemroot%\system32\com\dmp"
Sistema mínimo Windows XP

 

Nota

A partir de Windows Server 2003, solo los administradores tienen privilegios de acceso de lectura a los archivos de volcado com+.

 

EventsEnabled

Entrada Valor
Descripción Indica si los eventos están habilitados para la aplicación.
Access ReadWrite
Tipo Bool
Default True
Sistema mínimo Windows 2000

 

ID

Entrada Valor
Descripción GUID que representa la aplicación. Esta propiedad se devuelve cuando se llama al método de propiedad Key en un objeto de esta colección.
Access WriteOnce
Tipo String
Predeterminado <Generado>
Sistema mínimo Windows 2000

 

Identidad

Entrada Valor
Descripción Establece la identidad del proceso del servidor para la aplicación. Especifique una cuenta de usuario válida o "Usuario interactivo" para que la aplicación asuma la identidad del usuario que ha iniciado sesión. También puede especificar las cadenas "nt authority\localservice", "nt authority\networkservice" y "nt authority\system". La contraseña predeterminada para estas tres cuentas es "" (cadena vacía).
Access
Tipo
Valor predeterminado
Sistema mínimo Windows 2000

 

La propiedad Identity no está habilitada para las aplicaciones de biblioteca, que se ejecutan en el proceso de cliente.

La propiedad Password debe establecerse al mismo tiempo que Identity, antes de usar SaveChanges, porque la contraseña y la identidad se validan antes de guardarse. Si la contraseña y la identidad no se sincronizan, un administrador no puede iniciar la aplicación hasta que los restablezca.

ImpersonationLevel

Entrada Valor
Descripción Establece el nivel de suplantación usado para las llamadas realizadas a otras aplicaciones.
Access ReadWrite
Tipo Valores posibles largos:COMAdminImpersonationAnonymous (1)COMAdminImpersonationIdentify (2)COMAdminImpersonationImpersonate (3)COMAdminImpersonationDelegate (4)
Default COMAdminImpersonationImpersonate (3)
Sistema mínimo Windows 2000

 

IsEnabled

Entrada Valor
Descripción Si la aplicación o el componente COM+ está deshabilitado, IsEnabled es False. Si la aplicación o el componente COM+ está habilitado, IsEnabled es True.
Access ReadWrite
Tipo Bool
Default True
Sistema mínimo Windows XP

 

IsSystem

Entrada Valor
Descripción Identifica las aplicaciones del sistema COM+.
Access ReadOnly
Tipo Bool
Valor predeterminado False
Sistema mínimo Windows 2000

 

MaxDumpCount

Entrada Valor
Descripción Indica el número máximo de archivos que se van a generar antes de sobrescribirse.
Access ReadWrite
Tipo Long (1-200)
Predeterminado 5
Sistema mínimo Windows XP

 

Nombre

Entrada Valor
Descripción Nombre de la aplicación. Se quitan espacios adicionales al principio y al final de la cadena. Esta propiedad se devuelve cuando se llama al método de propiedad Name en un objeto de esta colección.
Access ReadWrite
Tipo String
Predeterminado "Nueva aplicación"
Sistema mínimo Windows 2000

 

Nota

Se deben elegir nombres únicos para las aplicaciones. Si se crean varias aplicaciones con el mismo nombre, puede interferir con la referencia a las aplicaciones por nombre, lo que da lugar a un comportamiento imprevisible.

 

Contraseña

Entrada Valor
Descripción Establece la contraseña usada por el proceso de servidor para iniciar sesión en la identidad.
Access WriteOnly
Tipo String
Predeterminado ""
Sistema mínimo Windows 2000

 

La contraseña debe establecerse al mismo tiempo que Identity, antes de usar SaveChanges, ya que la contraseña y la identidad se validan antes de guardarse. Si la contraseña y la identidad no se sincronizan, un administrador no puede iniciar la aplicación hasta que los restablezca.

QCAuthenticateMsgs

Entrada Valor
Descripción Indica en qué circunstancias se autentican las solicitudes en cola a una aplicación.
Access ReadWrite
Tipo Valores posibles largos:COMAdminQCMessageAuthenticateSecureApps (0)COMAdminQCMessageAuthenticateOff (1)COMAdminQCMessageAuthenticateOn (2)
Default COMAdminQCMessageAuthenticateSecureApps (0)
Sistema mínimo Windows XP

 

QCListenerMaxThreads

Entrada Valor
Descripción Indica el número máximo de subprocesos de agente de escucha simultáneos. El intervalo válido para esta propiedad es de 0 a 1000. Para una aplicación recién creada, la configuración se deriva del algoritmo que se usa actualmente para determinar el número predeterminado de subprocesos de agente de escucha: 16 veces el número de CPU en el servidor.
Access ReadWrite
Tipo Long (0-1000)
Default 0
Sistema mínimo Windows XP

 

Nota

Esta propiedad también está disponible con la funcionalidad de lectura y escritura de la pestaña Cola de la herramienta administrativa Servicios de componentes.

 

QueueListenerEnabled

Entrada Valor
Descripción Indica si el agente de escucha de componentes en cola está habilitado para la aplicación. Si está habilitado, se inicia el agente de escucha cuando se inicia la aplicación. Esta propiedad solo surte efecto si QueuingEnabled está establecido en True.
Access ReadWrite
Tipo Bool
Valor predeterminado False
Sistema mínimo Windows 2000

 

QueuingEnabled

Entrada Valor
Descripción Indica si el servicio Com+ Queued Components está habilitado para la aplicación.
Access ReadWrite
Tipo Bool
Valor predeterminado False
Sistema mínimo Windows 2000

 

RecycleActivationLimit

Entrada Valor
Descripción Indica el número máximo de activaciones de objetos configurados en la aplicación que se aceptarán antes de reciclar el proceso. El número predeterminado de activaciones es 0.
Access ReadWrite
Tipo Long (0-1048576)
Default 0
Sistema mínimo Windows XP

 

RecycleCallLimit

Entrada Valor
Descripción Indica el número máximo de llamadas para permitir que los objetos configurados de la aplicación acepten antes de reciclar el proceso. El número predeterminado de llamadas es 0.
Access ReadWrite
Tipo Long (0-1048576)
Default 0
Sistema mínimo Windows XP

 

RecycleExpirationTimeout

Entrada Valor
Descripción Indica la cantidad de tiempo (en minutos) para permitir que un proceso reciclado se ejecute antes de apagarlo. La cuenta atrás comienza inmediatamente después de reciclar el proceso. El tiempo de espera de expiración máximo es de 1440 minutos (24 horas) y el valor predeterminado es de 15 minutos.
Access ReadWrite
Tipo Long (1-1440)
Default 15
Sistema mínimo Windows XP

 

RecycleLifetimeLimit

Entrada Valor
Descripción Indica el número máximo de minutos para permitir que un proceso se ejecute antes de reciclarlo. El límite máximo de duración es de 30240 minutos (21 días) y el valor predeterminado es 0 minutos.
Access ReadWrite
Tipo Long (0-30240)
Default 0
Sistema mínimo Windows XP

 

RecycleMemoryLimit

Entrada Valor
Descripción Indica la cantidad máxima de uso de memoria (en kilobytes) permitido un proceso antes de que se recicla. Si el uso de memoria del proceso supera el número especificado durante un período de más de un minuto, el proceso se recicla. La cantidad predeterminada de uso de memoria es de 0 KB.
Access ReadWrite
Tipo Long (0-1048576)
Default 0
Sistema mínimo Windows XP

 

Replicable

Entrada Valor
Descripción Indica si la aplicación se puede replicar.
Access ReadWrite
Tipo Bool
Default True
Sistema mínimo Windows XP

 

RunForever

Entrada Valor
Descripción Permite que un proceso de servidor continúe si una aplicación está inactiva. Si se establece en True, el proceso del servidor no se cierra cuando se deja inactivo. Si se establece en False, el proceso se cierra según el valor establecido por la propiedad ShutdownAfter. RunForever no está habilitado para las aplicaciones de biblioteca (en proceso).
Access ReadWrite
Tipo Bool
Valor predeterminado False
Sistema mínimo Windows 2000

 

ServiceName

Entrada Valor
Descripción Nombre del servicio correspondiente a la aplicación configurada para ejecutarse como una aplicación de servicio. Si este valor es NULL, la aplicación no está configurada para ejecutarse como servicio. De lo contrario, la información de configuración del servicio se puede encontrar con el nombre del servicio.
Access ReadOnly
Tipo String
Predeterminado ""
Sistema mínimo Windows XP

 

ShutdownAfter

Entrada Valor
Descripción Establece el retraso antes de apagar un proceso de servidor después de que se quede inactivo. La latencia de apagado oscila entre 0 y 1440 minutos (24 horas). Si RunForever está establecido en True, esta propiedad se omite. ShutdownAfter no está habilitado para las aplicaciones de biblioteca (en proceso).
Access ReadWrite
Tipo Long (0-1440)
Default 3
Sistema mínimo Windows 2000

 

SoapActivated

Entrada Valor
Descripción Indica si esta aplicación se expone para su consumo a través del protocolo SOAP.
Access ReadWrite
Tipo Bool
Valor predeterminado False
Sistema mínimo Windows Server 2003

 

SoapBaseUrl

Entrada Valor
Descripción Punto de conexión de dirección URL en el que esta aplicación se expone a través del protocolo SOAP.
Access ReadWrite
Tipo String
Predeterminado ""
Sistema mínimo Windows Server 2003

 

SoapMailTo

Entrada Valor
Descripción La dirección de correo electrónico en la que esta aplicación se expone a través del protocolo SOAP.
Access ReadWrite
Tipo String
Predeterminado ""
Sistema mínimo Windows Server 2003

 

SoapVRoot

Entrada Valor
Descripción Directorio raíz virtual de IIS en el que residen los scripts de acceso que exponen la aplicación a través del protocolo SOAP.
Access ReadWrite
Tipo String
Predeterminado ""
Sistema mínimo Windows Server 2003

 

SRPEnabled

Entrada Valor
Descripción Determina la directiva de restricción de software (SRP) para la aplicación. Si se establece en True, se usa la propiedad SRPTrustLevel de la aplicación. Si se establece en False, se usan las directivas de restricción de software de la configuración de seguridad local. La configuración de seguridad local se controla a través del complemento Directiva de seguridad local de Microsoft Management Console.
Access ReadWrite
Tipo Bool
Valor predeterminado False
Sistema mínimo Windows XP

 

SRPTrustLevel

Entrada Valor
Descripción Indica el nivel de confianza de la directiva de restricción de software (SRP) de la aplicación. Esta propiedad solo se usa si la propiedad SRPEnabled está establecida en True. El nivel de confianza de SRP hace referencia al nivel de confianza que está dispuesto a conceder a una aplicación. Un nivel de confianza SRP sin restricciones corresponde al valor de enumeración SAFER_LEVELID_FULLYTRUSTED, mientras que un nivel de confianza de SRP no permitido corresponde al valor de enumeración SAFER_LEVELID_DISALLOWED. La enumeración de los niveles de confianza se define en Winsafer.h.
Access ReadWrite
Tipo Valores posibles largos:SAFER_LEVELID_DISALLOWED (0x0)SAFER_LEVELID_FULLYTRUSTED (0x40000)
Default SAFER_LEVELID_FULLYTRUSTED (0x40000)
Sistema mínimo Windows XP

 

Una aplicación en la que esté dispuesto a confiar con el acceso sin restricciones debe tener la seguridad más estricta asociada. Las aplicaciones sin restricciones solo pueden cargar componentes sin restricciones, mientras que no se permitirá que las aplicaciones no permitidas se ejecuten y, por lo tanto, no puedan cargar ningún componente.

Consulte también

Colecciones de administración de COM+