Win32_DCOMApplicationSetting class
The Win32_DCOMApplicationSetting WMI class represents the settings of a DCOM application. It contains DCOM configuration options associated with the AppID key in the registry. These options are valid on the components logically grouped under the given application class.
The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties. Properties are listed in alphabetic order, not MOF order.
Syntax
[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;
};
Members
The Win32_DCOMApplicationSetting class has these types of members:
Methods
The Win32_DCOMApplicationSetting class has these methods.
| Method | Description |
|---|---|
| GetAccessSecurityDescriptor | Gets the security descriptor that controls who is allowed to access a DCOM application. |
| GetConfigurationSecurityDescriptor | Gets the security descriptor that controls who is allowed to configure a DCOM application. |
| GetLaunchSecurityDescriptor | Gets the security descriptor that controls who is allowed to launch a DCOM application. |
| SetAccessSecurityDescriptor | Updates the access security descriptor of the DCOM application with a new security descriptor that is defined by an instance of the Win32_SecurityDescriptor class. |
| SetConfigurationSecurityDescriptor | Updates the configuration security descriptor of the DCOM application with a new security descriptor that is defined by an instance of the Win32_SecurityDescriptor class. |
| SetLaunchSecurityDescriptor | Updates the launch security descriptor of the DCOM application with a new security descriptor that is defined by an instance of the Win32_SecurityDescriptor class. |
Properties
The Win32_DCOMApplicationSetting class has these properties.
-
AppID
-
-
Data type: string
-
Access type: Read-only
-
Qualifiers: Key, MappingStrings ("Win32Registry|HKEY_LOCAL_MACHINE\\SOFTWARE\\Classes\\AppID\\{GUID}[Default]")
Globally unique identifier (GUID) for this DCOM application.
-
-
AuthenticationLevel
-
-
Data type: uint32
-
Access type: Read/write
-
Qualifiers: MappingStrings ("Win32Registry|HKEY_LOCAL_MACHINE\\SOFTWARE\\Classes\\AppID\\{GUID}[AuthenticationLevel]")
Minimum client authentication level required by this COM server. If NULL, the default values are used.
-
-
None (1)
-
None (no authentication is performed)
-
Connect (2)
-
Connect (authentication is performed only when the client establishes a relationship with the application)
-
Call (3)
-
Call (authentication is performed only at the beginning of each call when the application receives the request)
-
Packet (4)
-
Packet (authentication is performed on all of the data received from the client)
-
PacketIntegrity (5)
-
PacketIntegrity (all of the data transferred between the client and the application is authenticated and verified)
-
PacketPrivacy (6)
-
PacketPrivacy (the properties of the other authentication levels are used and all of the data is encrypted)
Caption
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MaxLen (64)
Short textual description of the current object.
This property is inherited from CIM_Setting.
CustomSurrogate
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MappingStrings ("Win32Registry|HKEY_LOCAL_MACHINE\\SOFTWARE\\Classes\\AppID\\{GUID}[DllSurrogate]")
Name of the custom surrogate in which the in-process DCOM application is activated. If this value is NULL and the UseSurrogate key is TRUE, then the system provides a surrogate process.
Description
-
Data type: string
-
Access type: Read-only
Textual description of the current object.
This property is inherited from CIM_Setting.
EnableAtStorageActivation
-
Data type: boolean
-
Access type: Read-only
-
Qualifiers: MappingStrings ("Win32Registry|HKEY_LOCAL_MACHINE\\SOFTWARE\\Classes\\AppID\\{GUID}[ActivateAtStorage]")
DCOM application retrieves the saved state of the application or begins from the state in which the application is first initialized.
LocalService
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MappingStrings ("Win32Registry|HKEY_LOCAL_MACHINE\\SOFTWARE\\Classes\\AppID\\{GUID}[LocalService]")
Name for the services provided by the DCOM application.
RemoteServerName
-
Data type: string
-
Access type: Read/write
-
Qualifiers: MappingStrings ("Win32Registry|HKEY_LOCAL_MACHINE\\SOFTWARE\\Classes\\AppID\\{GUID}[RemoteServerName]")
Name of the remote server where the application is activated.
RunAsUser
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MappingStrings ("Win32Registry|HKEY_LOCAL_MACHINE\\SOFTWARE\\Classes\\AppID\\{GUID}[RunAs]")
Specific user account under which the application is to be run on activation.
ServiceParameters
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MappingStrings ("Win32Registry|HKEY_LOCAL_MACHINE\\SOFTWARE\\Classes\\AppID\\{GUID}[ServiceParameters]")
Command-line parameters passed to the DCOM application. This is valid only if the application is written as a Windows-based service.
SettingID
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MaxLen (256)
Identifier by which the current object is known.
This property is inherited from CIM_Setting.
UseSurrogate
-
Data type: boolean
-
Access type: Read/write
-
Qualifiers: MappingStrings ("Win32Registry|HKEY_LOCAL_MACHINE\\SOFTWARE\\Classes\\AppID\\{GUID}[DllSurrogate]")
DCOM application can be activated as an out-of-process server by use of a surrogate executable file.
Remarks
The Win32_DCOMApplicationSetting class is derived from Win32_COMSetting.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista |
| Minimum supported server |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for