Win32_DCOMApplicationSetting classe
La classe WMI Win32_DCOMApplicationSetting représente les paramètres d’une application DCOM. Il contient les options de configuration DCOM associées à la clé AppID dans le Registre. Ces options sont valides sur les composants regroupés logiquement sous la classe d’application donnée.
La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés sont répertoriées dans l’ordre alphabétique, et non dans l’ordre MOF.
Syntaxe
[Dynamic, Provider("CIMWin32"), UUID("{E5D8A561-F6C0-11d2-B35E-00105A1F8569}"), AMENDMENT]
class Win32_DCOMApplicationSetting : Win32_COMSetting
{
string Caption;
string Description;
string SettingID;
string AppID;
uint32 AuthenticationLevel;
string CustomSurrogate;
boolean EnableAtStorageActivation;
string LocalService;
string RemoteServerName;
string RunAsUser;
string ServiceParameters;
boolean UseSurrogate;
};
Membres
La classe Win32_DCOMApplicationSetting comporte les types de membres suivants :
Méthodes
La classe Win32_DCOMApplicationSetting a ces méthodes.
| Méthode | Description |
|---|---|
| GetAccessSecurityDescriptor | Obtient le descripteur de sécurité qui contrôle qui est autorisé à accéder à une application DCOM. |
| GetConfigurationSecurityDescriptor | Obtient le descripteur de sécurité qui contrôle qui est autorisé à configurer une application DCOM. |
| GetLaunchSecurityDescriptor | Obtient le descripteur de sécurité qui contrôle qui est autorisé à lancer une application DCOM. |
| SetAccessSecurityDescriptor | Mises à jour le descripteur de sécurité d’accès de l’application DCOM avec un nouveau descripteur de sécurité défini par un instance de la classe Win32_SecurityDescriptor. |
| SetConfigurationSecurityDescriptor | Mises à jour le descripteur de sécurité de configuration de l’application DCOM avec un nouveau descripteur de sécurité défini par un instance de la classe Win32_SecurityDescriptor. |
| SetLaunchSecurityDescriptor | Mises à jour le descripteur de sécurité de lancement de l’application DCOM avec un nouveau descripteur de sécurité défini par un instance de la classe Win32_SecurityDescriptor. |
Propriétés
La classe Win32_DCOMApplicationSetting a ces propriétés.
-
AppID
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : Key, MappingStrings (« Win32Registry|HKEY_LOCAL_MACHINE\\SOFTWARE\\Classes\\AppID\\{GUID}[Default]")
Identificateur global unique (GUID) pour cette application DCOM.
-
-
AuthenticationLevel
-
-
Type de données : uint32
-
Type d’accès : Lecture/écriture
-
Qualificateurs : MappingStrings (« Win32Registry|HKEY_LOCAL_MACHINE\\SOFTWARE\\Classes\\AppID\\{GUID}[AuthenticationLevel]")
Niveau d’authentification client minimal requis par ce serveur COM. Si la valeur est NULL, les valeurs par défaut sont utilisées.
-
-
Aucun (1)
-
Aucun (aucune authentification n’est effectuée)
-
Connect (2)
-
Connexion (l’authentification est effectuée uniquement lorsque le client établit une relation avec l’application)
-
Appel (3)
-
Appel (l’authentification est effectuée uniquement au début de chaque appel lorsque l’application reçoit la demande)
-
Paquet (4)
-
Paquet (l’authentification est effectuée sur toutes les données reçues du client)
-
PacketIntegrity (5)
-
PacketIntegrity (toutes les données transférées entre le client et l’application sont authentifiées et vérifiées)
-
PacketPrivacy (6)
-
PacketPrivacy (les propriétés des autres niveaux d’authentification sont utilisées et toutes les données sont chiffrées)
Caption
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (64)
Brève description textuelle de l’objet actuel.
Cette propriété est héritée de CIM_Setting.
CustomSurrogate
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|HKEY_LOCAL_MACHINE\\SOFTWARE\\Classes\\AppID\\{GUID}[DllSurrogate]")
Nom du substitut personnalisé dans lequel l’application DCOM in-process est activée. Si cette valeur est NULL et que la clé UseSurrogate a la valeur TRUE, le système fournit un processus de substitution.
Description
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Description textuelle de l’objet actuel.
Cette propriété est héritée de CIM_Setting.
EnableAtStorageActivation
-
Type de données : booléen
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|HKEY_LOCAL_MACHINE\\SOFTWARE\\Classes\\AppID\\{GUID}[ActivateAtStorage]")
L’application DCOM récupère l’état enregistré de l’application ou commence à partir de l’état dans lequel l’application est initialisée pour la première fois.
LocalService
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|HKEY_LOCAL_MACHINE\\SOFTWARE\\Classes\\AppID\\{GUID}[LocalService]")
Nom des services fournis par l’application DCOM.
RemoteServerName
-
Type de données : chaîne
-
Type d’accès : Lecture/écriture
-
Qualificateurs : MappingStrings (« Win32Registry|HKEY_LOCAL_MACHINE\\SOFTWARE\\Classes\\AppID\\{GUID}[RemoteServerName]")
Nom du serveur distant sur lequel l’application est activée.
RunAsUser
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|HKEY_LOCAL_MACHINE\\SOFTWARE\\Classes\\AppID\\{GUID}[RunAs]")
Compte d’utilisateur spécifique sous lequel l’application doit être exécutée lors de l’activation.
ServiceParameters
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|HKEY_LOCAL_MACHINE\\SOFTWARE\\Classes\\AppID\\{GUID}[ServiceParameters]")
Paramètres de ligne de commande passés à l’application DCOM. Cela est valide uniquement si l’application est écrite en tant que service Windows.
SettingID
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (256)
Identificateur par lequel l’objet actuel est connu.
Cette propriété est héritée de CIM_Setting.
UseSurrogate
-
Type de données : booléen
-
Type d’accès : Lecture/écriture
-
Qualificateurs : MappingStrings (« Win32Registry|HKEY_LOCAL_MACHINE\\SOFTWARE\\Classes\\AppID\\{GUID}[DllSurrogate]")
L’application DCOM peut être activée en tant que serveur hors processus à l’aide d’un fichier exécutable de substitution.
Notes
La classe Win32_DCOMApplicationSetting est dérivée de Win32_COMSetting.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| Espace de noms |
Racine\CIMV2 |
| MOF |
|
| DLL |
|