Collection d’applications
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.
Collections associées
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
- AccessChecksLevel
- Activation
- ApplicationAccessChecksEnabled
- ApplicationDirectory
- ApplicationProxy
- ApplicationProxyServerName
- AppPartitionID
- Authentification
- AuthenticationCapability
- Modifiable
- CommandLine
- ConcurrentApps
- CreatedBy
- CRMEnabled
- CRMLogFile
- Délétible
- Description
- DumpEnabled
- DumpOnException
- DumpOnFailfast
- DumpPath
- ÉvénementsEnabled
- Identifiant
- Identité
- ImpersonationLevel
- IsEnabled
- IsSystem
- MaxDumpCount
- Nom
- Mot de passe
- QCAuthenticateMsgs
- QCListenerMaxThreads
- QueueListenerEnabled
- QueuingEnabled
- RecycleActivationLimit
- RecycleCallLimit
- RecycleExpirationTimeout
- RecycleLifetimeLimit
- RecycleMemoryLimit
- Reproductible
- RunForever
- ServiceName
- ShutdownAfter
- SoapActivated
- SoapBaseUrl
- SoapMailTo
- SoapVRoot
- SRPEnabled
- SRPTrustLevel
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