Win32_TSRemoteControlSetting class
The Win32_TSRemoteControlSetting WMI class defines the remote control configuration settings for the Win32_Terminal class.
The following syntax is simplified from MOF code and includes all defined and inherited properties, in alphabetical order. For reference information on methods, see the table of methods later in this topic.
Syntax
[dynamic, provider("Win32_WIN32_TSREMOTECONTROLSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSRemoteControlSetting : Win32_TerminalSetting
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
string TerminalName;
uint32 LevelOfControl;
uint32 PolicySourceLevelOfControl;
uint32 RemoteControlPolicy;
};
Members
The Win32_TSRemoteControlSetting class has these types of members:
Methods
The Win32_TSRemoteControlSetting class has these methods.
| Method | Description |
|---|---|
| RemoteControl | Sets the LevelOfControl property of this class. |
Properties
The Win32_TSRemoteControlSetting class has these properties.
-
Caption
-
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MaxLen (64)
Short description (one-line string) of the object.
This property is inherited from CIM_ManagedSystemElement.
-
-
Description
-
-
Data type: string
-
Access type: Read-only
Description of the object.
This property is inherited from CIM_ManagedSystemElement.
-
-
InstallDate
-
-
Data type: datetime
-
Access type: Read-only
-
Qualifiers: Mappingstrings ("MIF.DMTF|ComponentID|001.5")
The date the object was installed. A lack of a value does not indicate that the object is not installed.
This property is inherited from CIM_ManagedSystemElement.
-
-
LevelOfControl
-
-
Data type: uint32
-
Access type: Read-only
Level of control for the session, which specifies whether the session will only be viewed by the remote user, or viewed and controlled through a keyboard and mouse. For more information, see the Remarks section of the RemoteControl method. The following values are supported.
-
-
Disable (0)
-
Remote control is disabled.
-
EnableInputNotify (1)
-
The user of remote control has full control of the user's session, with the user's permission.
-
EnableInputNoNotify (2)
-
The user of remote control has full control of the user's session; the user's permission is not required.
-
EnableNoInputNotify (3)
-
The user of remote control can view the session remotely, with the user's permission; the remote user cannot actively control the session.
-
EnableNoInputNoNotify (4)
-
The user of remote control can view the session remotely, but not actively control the session; the user's permission is not required.
Name
-
Data type: string
-
Access type: Read-only
The name of the object.
This property is inherited from CIM_ManagedSystemElement.
PolicySourceLevelOfControl
-
Data type: uint32
-
Access type: Read-only
Indicates whether the LevelOfControl property is configured by the server, group policy, or by default.
0 (0x0)
Server
1 (0x1)
Group policy
2 (0x2)
Default
RemoteControlPolicy
-
Data type: uint32
-
Access type: Read/write
The policy the server uses to retrieve the remote control settings.
Per User (0)
The user's remote control settings are in effect.
Server-Override (1)
The user's remote control settings are overridden by the server.
Status
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MaxLen (10)
Current status of the object. Various operational and nonoperational statuses can be defined. Operational statuses include: "OK", "Degraded", and "Pred Fail" (an element, such as a SMART-enabled hard disk drive, may be functioning properly but predicting a failure in the near future). Nonoperational statuses include: "Error", "Starting", "Stopping", and "Service". The latter, "Service", could apply during mirror-resilvering of a disk, reload of a user permissions list, or other administrative work. Not all such work is on-line, yet the managed element is neither "OK" nor in one of the other states.
This property is inherited from CIM_ManagedSystemElement.
("OK")
("Error")
("Degraded")
("Unknown")
("Pred Fail")
("Starting")
("Stopping")
("Service")
TerminalName
-
Data type: string
-
Access type: Read-only
The name of the terminal.
This property is inherited from Win32_TerminalSetting.
Remarks
To connect to the \root\CIMV2\TerminalServices namespace, the authentication level must include packet privacy. For C/C++ calls, this would be an authentication level of RPC_C_AUTHN_LEVEL_PKT_PRIVACY. For Visual Basic and scripting calls, this would be an authentication level of WbemAuthenticationLevelPktPrivacy or "pktPrivacy", with a value of 6. The following Visual Basic Scripting Edition (VBScript) example shows how to connect to a remote computer with packet privacy.
strComputer = "RemoteServer1"
Set objServices = GetObject( _
"winmgmts:{authenticationLevel=pktPrivacy}!Root/CIMv2/TerminalServices")
Managed Object Format (MOF) files contain the definitions for Windows Management Instrumentation (WMI) classes. MOF files are not installed as part of the Microsoft Windows Software Development Kit (SDK). They are installed on the server when you add the associated role by using the Server Manager. For more information about MOF files, see Managed Object Format (MOF).
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista |
| Minimum supported server |
Windows Server 2008 |
| Namespace |
Root\CIMv2\TerminalServices |
| MOF |
|
| DLL |
|