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.
| Value | Meaning |
|---|
- 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 Windows 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
| Minimum supported client | Windows XP |
|---|
| Minimum supported server | Windows Server 2003 |
|---|
| MOF | Tscfgwmi.mof |
|---|
| DLL | Tscfgwmi.dll |
|---|
| Namespace | \root\CIMV2\TerminalServices on Windows Vista and Windows Server 2008\root\CIMV2 on Windows XP and Windows Server 2003 |
|---|
See Also
- Win32_TSRemoteControlSetting
Send comments about this topic to Microsoft
Build date: 10/19/2009