大网数据广告活动
Windows 系统接口

Win32_DCOMApplicationSetting class

· 52CE 我爱测

The Win32_DCOMApplicationSetting&\#8194;WMI class represents the settings of a DCOM application.

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

See also

Win32_COMSetting

Operating System Classes

Privilege Constants

WMI Security Descriptor Objects

Changing Access Security on Securable Objects

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 05/31/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。