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 Terminal 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.

Requirements

See Also

Win32_TSRemoteControlSetting

Send comments about this topic to Microsoft

Build date: 9/25/2008