RemoteControl method of the Win32_TSRemoteControlSetting class
The RemoteControl method sets the LevelOfControl property.
Syntax
uint32 RemoteControl(
[in] uint32 LevelOfControl
);
Parameters
-
LevelOfControl [in]
-
New value for the LevelOfControl property, 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. 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.
Return value
Returns 0 on success, otherwise returns a WMI error code. Refer to Remote Desktop Services WMI Provider Error Codes for a list of these values. The method returns an error if the setting is under group policy control.
Remarks
Full control of a session means that the remote user can actively control the user's session with a keyboard and mouse.
When a user attempts to establish a remote-control connection, the system displays a message to the remote client, requesting permission to either view or participate actively in the remote session.
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 |
|