Collection d’applications

  • Article

Contient un objet pour chaque application COM+ installée sur l’ordinateur local. Les propriétés exposées par ces objets contiennent tous les paramètres effectués au niveau de l’application.

Vous définissez les propriétés des composants au sein d’une application à l’aide de la collection Components associée. Vous attribuez des rôles à une application à l’aide de la collection Roles associée.

Pour installer des composants dans une application, utilisez des méthodes sur l’objet COMAdminCatalog . Pour installer une application à partir d’un fichier ou pour arrêter ou exporter une application, utilisez également des méthodes sur l’objet COMAdminCatalog . Sinon, pour créer une application, vous pouvez ajouter un objet à la collection Applications .

Cette collection prend en charge les méthodes Add et Remove de l’objet COMAdminCatalogCollection .

Membres

La collection Applications hérite de l’interface IUnknown , mais n’a pas de membres supplémentaires.

Vous pouvez naviguer de cette collection vers l’une des collections suivantes :

Vous pouvez accéder à cette collection à partir des collections suivantes :

Propriétés

Les propriétés suivantes sont prises en charge par l’objet COMAdminCatalogObject au sein de la collection :

3GigSupportEnabled

Entrée Valeur
Description Indique si l’application peut utiliser 3 Go de mémoire dans son processus. Si cette option n’est pas activée, l’application ne peut utiliser que 2 Go de mémoire.
Access Lecture/écriture
Type Bool
Default False
Système minimal Windows 2000

 

AccessChecksLevel

Entrée Valeur
Description Indique si les vérifications d’accès sont effectuées uniquement au niveau du processus ou au niveau du processus et du composant. Il est recommandé d’utiliser les constantes de l’énumération et non les valeurs numériques.
Access Lecture/écriture
Type Valeurs longues possibles : COMAdminAccessChecksApplicationLevel (0) COMAdminAccessChecksApplicationComponentLevel (1)
Default COMAdminAccessChecksApplicationComponentLevel (1)
Système minimal Windows 2000

 

Activation

Entrée Valeur
Description L’activation locale indique que les objets de l’application s’exécutent dans un processus de serveur local dédié (application serveur). L’activation in-process indique que les objets s’exécutent dans le processus de leur créateur (application de bibliothèque).
Access Lecture/écriture
Type Valeurs possibles longues :COMAdminActivationInproc (0)COMAdminActivationLocal (1)
Default COMAdminActivationLocal (1)
Système minimal Windows 2000

 

ApplicationAccessChecksEnabled

Entrée Valeur
Description Indique si des vérifications d’accès sont effectuées pour l’application lorsque les clients y effectuent des appels.
Access Lecture/écriture
Type Bool
Default True
Système minimal Windows 2000

 

ApplicationDirectory

Entrée Valeur
Description Chemin d’accès complet à l’application. Ces informations sont nécessaires lorsque vous configurez des assemblys côte à côte (SxS). Les assemblys côte à côte (SxS) permettent aux applications ASP de spécifier la version d’une DLL système prise en charge par SxS, telle que MSVCRT, MSXML, COMCTL, GDIPLUS, etc. Par exemple, si votre application ASP s’appuie sur MSVCRT version 2.0, vous pouvez vous assurer que votre application utilise toujours MSVCRT version 2.0 même après l’application des Service Packs au serveur. Toute nouvelle version de MSVCRT est toujours installée sur l’ordinateur, mais la version 2.0 reste et est utilisée par votre application. Les DLL prises en charge par SxS sont stockées dans %WINDIR%\WinSxS.
Access Lecture/écriture
Type String
Valeur par défaut ""
Système minimal Windows XP

 

Notes

Une seule version d’une DLL système peut être utilisée dans n’importe quel pool d’applications, même si cette fonctionnalité est configurable au niveau de l’application. Par exemple, si l’application App1 utilise MSVCRT, version 2.5 et application App2 utilise MSVCRT, version 2.4, alors App1 et App2 ne doivent pas se trouver dans le même pool d’applications. Si c’est le cas, la version de MSVCRT de l’application chargée est d’abord chargée, et l’autre application est forcée à l’utiliser jusqu’à ce que les applications soient déchargées.

 

Pour plus d’informations, consultez « Assemblys côte à côte » dans Modifications apportées aux services COM+ dans IIS 6.0.

ApplicationProxy

Entrée Valeur
Description Indique si l’application est un proxy d’application.
Access Lecture seule
Type Bool
Default False
Système minimal Windows 2000

 

ApplicationProxyServerName

Entrée Valeur
Description Nom de serveur distant utilisé lors de l’exportation du proxy d’application. Le proxy d’application pointe vers ce nom de serveur lorsqu’il est installé sur un ordinateur client.
Access Lecture/écriture
Type String
Valeur par défaut ""
Système minimal Windows 2000

 

AppPartitionID

Entrée Valeur
Description GUID représentant l’ID de partition d’application.
Access Lecture seule
Type String
Valeur par défaut <Généré>
Système minimal Windows Server 2003

 

Authentification

Entrée Valeur
Description Définit le niveau d’authentification pour les appels, avec des valeurs correspondant aux paramètres d’authentification RPC (Remote Procedure Call). Lorsque COMAdminAuthenticationDefault est choisi, le paramètre de la propriété DefaultAuthenticationLevel de la collection LocalComputer est utilisé.
Access Lecture/écriture
Type Valeurs possibles longues :COMAdminAuthenticationDefault (0)COMAdminAuthenticationNone (1) COMAdminAuthenticationConnect (2)COMAdminAuthenticationCall (3)COMAdminAuthenticationPacket (4)COMAdminAuthenticationIntegrity (5)COMAdminAuthenticationPrivacy (6)
Default COMAdminAuthenticationPacket (4)
Système minimal Windows 2000

 

Notes

Pour les applications de bibliothèque (in-process), les seuls paramètres valides ici sont COMAdminAuthenticationDefault et COMAdminAuthenticationNone . Il est recommandé d’utiliser les constantes de l’énumération et non les valeurs numériques.

 

AuthenticationCapability

Entrée Valeur
Description Détermine quelle identité est présentée lorsque les appels sont empruntés.
Access Lecture/écriture
Type Valeurs possibles longues :COMAdminAuthenticationCapabilitiesNone (0x0)COMAdminAuthenticationCapabilitiesSecureReference (0x2)COMAdminAuthenticationCapabilitiesStaticCloaking (0x20)COMAdminAuthenticationCapabilitiesDynamicCloaking (0x40)
Default COMAdminAuthenticationCapabilitiesDynamicCloaking (0x40)
Système minimal Windows 2000

 

Modifiable

Entrée Valeur
Description Détermine si les modifications apportées aux paramètres de l’application ou à ceux de ses composants sont autorisées, par programmation ou par le biais de l’outil d’administration Des services de composants.
Access Lecture/écriture
Type Bool
Default True
Système minimal Windows 2000

 

CommandLine

Entrée Valeur
Description Chaîne de ligne de commande à utiliser dans le débogage. L’application peut être lancée dans un débogueur avec la ligne de commande spécifiée.
Access Lecture/écriture
Type String
Valeur par défaut ""
Système minimal Windows 2000

 

ConcurrentApps

Entrée Valeur
Description Spécifie le nombre maximal d’applications pouvant être mises en pool qui peuvent s’exécuter simultanément.
Access Lecture/écriture
Type Long (1-1048576)
Default 1
Système minimal Windows XP

 

CreatedBy

Entrée Valeur
Description Chaîne d’information pour décrire qui a créé l’application.
Access Lecture/écriture
Type String
Valeur par défaut ""
Système minimal Windows 2000

 

CRMEnabled

Entrée Valeur
Description Détermine si le Resource Manager de compensation est activé.
Access Lecture/écriture
Type Bool
Default False
Système minimal Windows 2000

 

CRMLogFile

Entrée Valeur
Description Nom et chemin du fichier pour la conservation du journal pour le gestionnaire de ressources de compensation (CRM).
Access Lecture/écriture
Type String
Valeur par défaut ""
Système minimal Windows 2000

 

Délétible

Entrée Valeur
Description Définit si l’application peut être supprimée, soit par programmation, soit via l’outil d’administration des services de composants.
Access Lecture/écriture
Type Bool
Default True
Système minimal Windows 2000

 

Description

Entrée Valeur
Description Décrit l’application.
Access Lecture/écriture
Type String
Valeur par défaut ""
Système minimal Windows 2000

 

DumpEnabled

Entrée Valeur
Description Active le vidage de l’état d’une application COM+ au moment de l’échec dans un répertoire désigné.
Access Lecture/écriture
Type Bool
Default False
Système minimal Windows XP

 

Notes

Depuis Windows Server 2003, seuls les administrateurs disposent de privilèges d’accès en lecture aux fichiers de vidage COM+.

 

DumpOnException

Entrée Valeur
Description Active le vidage de l’état d’une application COM+ lorsque l’application provoque une exception non prise en charge et est terminée par le runtime COM+.
Access Lecture/écriture
Type Bool
Default False
Système minimal Windows XP

 

DumpOnFailfast

Entrée Valeur
Description Active le vidage de l’état d’une application COM+ en cas d’échec de l’application.
Access Lecture/écriture
Type Bool
Default False
Système minimal Windows XP

 

DumpPath

Entrée Valeur
Description Chemin d’accès du répertoire dans lequel les fichiers de vidage sont enregistrés.
Access Lecture/écriture
Type String
Valeur par défaut « %systemroot%\system32\com\dmp »
Système minimal Windows XP

 

Notes

Depuis Windows Server 2003, seuls les administrateurs disposent de privilèges d’accès en lecture aux fichiers de vidage COM+.

 

ÉvénementsEnabled

Entrée Valeur
Description Indique si les événements sont activés pour l’application.
Access Lecture/écriture
Type Bool
Default True
Système minimal Windows 2000

 

id

Entrée Valeur
Description GUID représentant l’application. Cette propriété est retournée lorsque la méthode de propriété Key est appelée sur un objet de cette collection.
Access WriteOnce
Type String
Valeur par défaut <Généré>
Système minimal Windows 2000

 

Identité

Entrée Valeur
Description Définit l’identité du processus serveur pour l’application. Spécifiez un compte d’utilisateur valide ou un « utilisateur interactif » pour que l’application assume l’identité de l’utilisateur actuellement connecté. Vous pouvez également spécifier les chaînes « nt authority\localservice », « nt authority\networkservice » et « nt authority\system ». Le mot de passe par défaut pour ces trois comptes est « » (chaîne vide).
Access
Type
Default
Système minimal Windows 2000

 

La propriété Identity n’est pas activée pour les applications de bibliothèque qui s’exécutent dans le processus client.

La propriété Password doit être définie en même temps que Identity, avant d’utiliser SaveChanges, car le mot de passe et l’identité sont validés avant d’être enregistrés. Si le mot de passe et l’identité ne sont pas synchronisés, l’application ne peut pas être lancée tant qu’ils n’ont pas été réinitialisés par un administrateur.

ImpersonationLevel

Entrée Valeur
Description Définit le niveau d’emprunt d’identité utilisé pour les appels effectués à d’autres applications.
Access Lecture/écriture
Type Valeurs possibles longues :COMAdminImpersonationAnonymous (1)COMAdminImpersonationIdentify (2)COMAdminImpersonationImpersonate (3)COMAdminImpersonationDelegate (4)
Default COMAdminImpersonationImpersonate (3)
Système minimal Windows 2000

 

IsEnabled

Entrée Valeur
Description Si l’application ou le composant COM+ est désactivé, IsEnabled a la valeur False. Si l’application ou le composant COM+ est activé, IsEnabled a la valeur True.
Access Lecture/écriture
Type Bool
Default True
Système minimal Windows XP

 

IsSystem

Entrée Valeur
Description Identifie les applications système COM+.
Access Lecture seule
Type Bool
Default False
Système minimal Windows 2000

 

MaxDumpCount

Entrée Valeur
Description Indique le nombre maximal de fichiers à générer avant le remplacement.
Access Lecture/écriture
Type Long (1-200)
Default 5
Système minimal Windows XP

 

Name

Entrée Valeur
Description Le nom de l’application. Les espaces supplémentaires au début et à la fin de la chaîne sont supprimés. Cette propriété est retournée lorsque la méthode de propriété Name est appelée sur un objet de cette collection.
Access Lecture/écriture
Type String
Valeur par défaut « Nouvelle application »
Système minimal Windows 2000

 

Notes

Des noms uniques doivent être choisis pour les applications. Si plusieurs applications sont créées avec le même nom, cela peut interférer avec le référencement des applications par leur nom, ce qui entraîne un comportement imprévisible.

 

Mot de passe

Entrée Valeur
Description Définit le mot de passe utilisé par le processus serveur pour se connecter sous l’identité.
Access WriteOnly
Type String
Valeur par défaut ""
Système minimal Windows 2000

 

Le mot de passe doit être défini en même temps que l’identité, avant d’utiliser SaveChanges, car le mot de passe et l’identité sont validés avant d’être enregistrés. Si le mot de passe et l’identité sont désynchronisés, l’application ne peut pas être lancée tant qu’elles n’ont pas été réinitialisées par un administrateur.

QCAuthenticateMsgs

Entrée Valeur
Description Indique dans quelles circonstances les demandes en file d’attente adressées à une application sont authentifiées.
Access Lecture/écriture
Type Valeurs longues possibles :COMAdminQCMessageAuthenticateSecureApps (0)COMAdminQCMessageAuthenticateOff (1)COMAdminQCMessageAuthenticateOn (2)
Default COMAdminQCMessageAuthenticateSecureApps (0)
Système minimal Windows XP

 

QCListenerMaxThreads

Entrée Valeur
Description Indique le nombre maximal de threads d’écouteurs simultanés. La plage valide pour cette propriété est comprise entre 0 et 1 000. Pour une application nouvellement créée, le paramètre est dérivé de l’algorithme actuellement utilisé pour déterminer le nombre par défaut de threads d’écouteurs : 16 fois le nombre de processeurs dans le serveur.
Access Lecture/écriture
Type Long (0-1000)
Default 0
Système minimal Windows XP

 

Notes

Cette propriété est également disponible avec la fonctionnalité de lecture/écriture à partir de l’onglet Mise en file d’attente de l’outil d’administration Services de composants.

 

QueueListenerEnabled

Entrée Valeur
Description Indique si l’écouteur de composants mis en file d’attente est activé pour l’application. Si cette option est activée, l’écouteur est lancé au démarrage de l’application. Cette propriété prend effet uniquement si QueuingEnabled a la valeur True.
Access Lecture/écriture
Type Bool
Default False
Système minimal Windows 2000

 

QueuingEnabled

Entrée Valeur
Description Indique si le service Composants mis en file d’attente COM+ est activé pour l’application.
Access Lecture/écriture
Type Bool
Default False
Système minimal Windows 2000

 

RecycleActivationLimit

Entrée Valeur
Description Indique le nombre maximal d’activations d’objets configurés dans l’application à accepter avant de recycler le processus. Le nombre d’activations par défaut est 0.
Access Lecture/écriture
Type Long (0-1048576)
Default 0
Système minimal Windows XP

 

RecycleCallLimit

Entrée Valeur
Description Indique le nombre maximal d’appels permettant aux objets configurés dans l’application d’accepter avant de recycler le processus. Le nombre d’appels par défaut est 0.
Access Lecture/écriture
Type Long (0-1048576)
Default 0
Système minimal Windows XP

 

RecycleExpirationTimeout

Entrée Valeur
Description Indique la durée d’exécution (en minutes) d’un processus recyclé avant de l’arrêter. Le compte à rebours commence immédiatement après le recyclage du processus. Le délai d’expiration maximal est de 1 440 minutes (24 heures) et la valeur par défaut est de 15 minutes.
Access Lecture/écriture
Type Long (1-1440)
Default 15
Système minimal Windows XP

 

RecycleLifetimeLimit

Entrée Valeur
Description Indique le nombre maximal de minutes pour permettre à un processus de s’exécuter avant de le recycler. La limite de durée de vie maximale est de 3 0240 minutes (21 jours), et la valeur par défaut est de 0 minutes.
Access Lecture/écriture
Type Long (0-30240)
Default 0
Système minimal Windows XP

 

RecycleMemoryLimit

Entrée Valeur
Description Indique la quantité maximale d’utilisation de la mémoire (en kilo-octets) autorisée par un processus avant d’être recyclé. Si l’utilisation de la mémoire du processus dépasse le nombre spécifié pendant une période de plus d’une minute, le processus est recyclé. La quantité par défaut d’utilisation de la mémoire est de 0 Ko.
Access Lecture/écriture
Type Long (0-1048576)
Default 0
Système minimal Windows XP

 

Reproductible

Entrée Valeur
Description Indique si l’application peut être répliquée.
Access Lecture/écriture
Type Bool
Default True
Système minimal Windows XP

 

RunForever

Entrée Valeur
Description Permet à un processus serveur de continuer si une application est inactive. S’il est défini sur True, le processus serveur ne s’arrête pas en cas d’inactivité. Si la valeur est False, le processus s’arrête en fonction de la valeur définie par la propriété ShutdownAfter. RunForever n’est pas activé pour les applications de bibliothèque (en cours de traitement).
Access Lecture/écriture
Type Bool
Default False
Système minimal Windows 2000

 

NomService

Entrée Valeur
Description Nom du service correspondant à l’application configurée pour s’exécuter en tant qu’application de service. Si cette valeur est NULL, l’application n’est pas configurée pour s’exécuter en tant que service. Sinon, les informations de configuration du service sont disponibles à l’aide du nom du service.
Access Lecture seule
Type String
Valeur par défaut ""
Système minimal Windows XP

 

ShutdownAfter

Entrée Valeur
Description Définit le délai avant l’arrêt d’un processus serveur après qu’il devient inactif. La latence d’arrêt varie de 0 à 1 440 minutes (24 heures). Si RunForever a la valeur True, cette propriété est ignorée. ShutdownAfter n’est pas activé pour les applications de bibliothèque (en cours de traitement).
Access Lecture/écriture
Type Long (0-1440)
Default 3
Système minimal Windows 2000

 

SoapActivated

Entrée Valeur
Description Indique si cette application est exposée pour consommation via le protocole SOAP.
Access Lecture/écriture
Type Bool
Default False
Système minimal Windows Server 2003

 

SoapBaseUrl

Entrée Valeur
Description Point de terminaison d’URL auquel cette application est exposée via le protocole SOAP.
Access Lecture/écriture
Type String
Valeur par défaut ""
Système minimal Windows Server 2003

 

SoapMailTo

Entrée Valeur
Description Adresse e-mail à laquelle cette application est exposée via le protocole SOAP.
Access Lecture/écriture
Type String
Valeur par défaut ""
Système minimal Windows Server 2003

 

SoapVRoot

Entrée Valeur
Description Répertoire racine virtuel IIS dans lequel résident les scripts d’accès qui exposent l’application via le protocole SOAP.
Access Lecture/écriture
Type String
Valeur par défaut ""
Système minimal Windows Server 2003

 

SRPEnabled

Entrée Valeur
Description Détermine la stratégie de restriction logicielle (SRP) pour l’application. Si la valeur est True, la propriété SRPTrustLevel de l’application est utilisée. Si la valeur est False, les stratégies de restriction logicielle des paramètres de sécurité locaux sont utilisées. Les paramètres de sécurité locaux sont contrôlés via le composant logiciel enfichable Stratégie de sécurité locale de la console de gestion Microsoft.
Access Lecture/écriture
Type Bool
Default False
Système minimal Windows XP

 

SRPTrustLevel

Entrée Valeur
Description Indique le niveau de confiance de la stratégie de restriction logicielle (SRP) de l’application. Cette propriété est utilisée uniquement si la propriété SRPEnabled a la valeur True. Le niveau de confiance SRP fait référence au niveau de confiance que vous êtes prêt à accorder à une application. Un niveau d’approbation SRP non restreint correspond à la valeur d’énumération SAFER_LEVELID_FULLYTRUSTED, tandis qu’un niveau d’approbation SRP non autorisé correspond à la valeur d’énumération SAFER_LEVELID_DISALLOWED. L’énumération des niveaux d’approbation est définie dans Winsafer.h.
Access Lecture/écriture
Type Valeurs possibles longues :SAFER_LEVELID_DISALLOWED (0x0)SAFER_LEVELID_FULLYTRUSTED (0x40000)
Default SAFER_LEVELID_FULLYTRUSTED (0x40000)
Système minimal Windows XP

 

Une application à laquelle vous êtes prêt à faire confiance avec un accès illimité doit être associée à la sécurité la plus stricte. Les applications non restreintes peuvent charger uniquement des composants non restreints, tandis que les applications non autorisées ne sont pas autorisées à s’exécuter et ne peuvent donc pas charger de composants.

Voir aussi

Regroupements d’administration COM+