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

See Also

Win32_TSRemoteControlSetting

Send comments about this topic to Microsoft

Build date: 6/26/2009