This topic has not yet been rated - Rate this topic

Win32_DCOMApplicationSetting class

Applies to: desktop apps only

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

Copy

class Win32_DCOMApplicationSetting : Win32_COMSetting
{
  string  AppID;
  uint32  AuthenticationLevel;
  string  Caption;
  string  CustomSurrogate;
  string  Description;
  boolean EnableAtStorageActivation;
  string  LocalService;
  string  RemoteServerName;
  string  RunAsUser;
  string  ServiceParameters;
  string  SettingID;
  boolean UseSurrogate;
};

Members

The Win32_DCOMApplicationSetting class has these types of members:

Methods
Properties

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. This method is available starting with Windows Vista. Windows Server 2003, Windows XP, Windows 2000, and Windows NT 4.0: This method is not available.
GetConfigurationSecurityDescriptor	Gets the security descriptor that controls who is allowed to configure a DCOM application. This method is available starting with Windows Vista. Windows Server 2003, Windows XP, Windows 2000, and Windows NT 4.0: This method is not available.
GetLaunchSecurityDescriptor	Gets the security descriptor that controls who is allowed to launch a DCOM application. This method is available starting with Windows Vista. Windows Server 2003, Windows XP, Windows 2000, and Windows NT 4.0: This method is not available.
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. This method is available starting with Windows Vista. Windows Server 2003, Windows XP, Windows 2000, and Windows NT 4.0: This method is not available.
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. This method is available starting with Windows Vista. Windows Server 2003, Windows XP, Windows 2000, and Windows NT 4.0: This method is not available.
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. This method is available starting with Windows Vista. Windows Server 2003, Windows XP, Windows 2000, and Windows NT 4.0: This method is not available.

Properties

The Win32_DCOMApplicationSetting class has these properties.

AppID

Data type: string
Access type: Read-only
Qualifiers: Key

Globally unique identifier (GUID) for this DCOM application.

AuthenticationLevel

Data type: uint32
Access type: Read/write

Minimum client authentication level required by this COM server. If NULL, the default values are used.

Value	Meaning
1	None (no authentication is performed)
2	Connect (authentication is performed only when the client establishes a relationship with the application)
3	Call (authentication is performed only at the beginning of each call when the application receives the request)
4	Packet (authentication is performed on all of the data received from the client)
5	PacketIntegrity (all of the data transferred between the client and the application is authenticated and verified)
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

Short description of the CIM_Setting object.

CustomSurrogate

Data type: string
Access type: Read-only

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

Description of the CIM_Setting object.

EnableAtStorageActivation

Data type: boolean
Access type: Read-only

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

Name for the services provided by the DCOM application.

RemoteServerName

Data type: string
Access type: Read-only

Name of the remote server where the application is activated.

RunAsUser

Data type: string
Access type: Read-only

Specific user account under which the application is to be run on activation.

ServiceParameters

Data type: string
Access type: Read-only

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

Identifier by which the CIM_Setting object is known.

UseSurrogate

Data type: boolean
Access type: Read-only

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.

Examples

For more information and script examples, see WMI Tasks for Scripts and Applications and the TechNet ScriptCenter Script Repository.

For more information and C++ code examples, see WMI C++ Application Examples.

Requirements

Minimum supported client	Windows 2000 Professional
Minimum supported server	Windows 2000 Server
Namespace	\root\CIMV2
MOF	Cimwin32.mof
DLL	Cimwin32.dll