_Classe DCOMApplicationSetting Win32
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 par ordre alphabétique, et non par 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 possède les types de membres suivants :
Méthodes
La classe Win32 _ DCOMApplicationSetting possède ces méthodes.
| Méthode | Description |
|---|---|
| GetAccessSecurityDescriptor | Obtient le descripteur de sécurité qui contrôle les personnes autorisées à accéder à une application DCOM. |
| GetConfigurationSecurityDescriptor | Obtient le descripteur de sécurité qui contrôle les personnes autorisées à configurer une application DCOM. |
| GetLaunchSecurityDescriptor | Obtient le descripteur de sécurité qui contrôle les personnes autorisées à lancer une application DCOM. |
| SetAccessSecurityDescriptor | Met à jour le descripteur de sécurité d’accès de l’application DCOM avec un nouveau descripteur de sécurité défini par une instance de la classe Win32 _ SecurityDescriptor . |
| SetConfigurationSecurityDescriptor | Met à jour le descripteur de sécurité de configuration de l’application DCOM avec un nouveau descripteur de sécurité défini par une instance de la classe Win32 _ SecurityDescriptor . |
| SetLaunchSecurityDescriptor | Met à jour le descripteur de sécurité de lancement de l’application DCOM avec un nouveau descripteur de sécurité défini par une 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) de cette application DCOM.
-
-
AuthenticationLevel
-
-
Type de données : UInt32
-
Type d’accès : lecture/écriture
-
Qualificateurs : MappingStrings ("Win32Registry | HKEY _ local _ machine machine \ \ \ \ classes \ \ AppID \ \ {GUID} [ AuthenticationLevel ] ")
Niveau minimal d’authentification du client 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)
-
Connecter (2)
-
Connecter (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)
Courte description textuelle de l’objet actuel.
Cette propriété est héritée du _ paramètre CIM.
CustomSurrogate
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings ("Win32Registry | HKEY _ local _ machine machine \ \ \ \ 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 est 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 du _ paramètre CIM.
EnableAtStorageActivation
-
Type de données : booléen
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings ("Win32Registry | HKEY _ local _ machine machine \ \ \ \ classes \ \ AppID \ \ {GUID} [ ActivateAtStorage ] ")
L’application DCOM récupère l’état enregistré de l’application ou commence à 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 machine \ \ \ \ 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 machine \ \ \ \ 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 machine \ \ \ \ 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 machine \ \ \ \ 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 du _ paramètre CIM.
UseSurrogate
-
Type de données : booléen
-
Type d’accès : lecture/écriture
-
Qualificateurs : MappingStrings ("Win32Registry | HKEY _ local _ machine machine \ \ \ \ 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 la _ comdéfinition Win32.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| Espace de noms |
\Cimv2 racine |
| MOF |
|
| DLL |
|