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

Minimum supported client
Windows Vista
Minimum supported server
Windows Server 2008
Namespace
Root\CIMv2\TerminalServices
MOF
TSCfgWmi.mof
DLL
TSCfgWmi.dll

See also

Win32_TSRemoteControlSetting