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
• Propriétés

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	CIMWin32.mof
DLL	CIMWin32.dll

Voir aussi

Win32_COMSetting

Classes du système d’exploitation

Constantes de privilèges

Objets de descripteur de sécurité WMI

Modification de la sécurité d’accès sur les objets sécurisables