CTRL_LEVEL enumeration (rdpencomapi.h)

  • Article

Defines the level of control that an attendee has on a session.

Syntax

typedef enum __MIDL___MIDL_itf_rdpencomapi_0000_0000_0001 {
  CTRL_LEVEL_MIN = 0,
  CTRL_LEVEL_INVALID = 0,
  CTRL_LEVEL_NONE = 1,
  CTRL_LEVEL_VIEW = 2,
  CTRL_LEVEL_INTERACTIVE = 3,
  CTRL_LEVEL_REQCTRL_VIEW = 4,
  CTRL_LEVEL_REQCTRL_INTERACTIVE = 5,
  CTRL_LEVEL_MAX = 5
} CTRL_LEVEL;

Constants

 
CTRL_LEVEL_MIN
Value: 0
Minimum enumeration value.
CTRL_LEVEL_INVALID
Value: 0
The control level is not valid.
CTRL_LEVEL_NONE
Value: 1
The attendee cannot view or interact with the session. This is the default.
CTRL_LEVEL_VIEW
Value: 2
The attendee can view the session.
CTRL_LEVEL_INTERACTIVE
Value: 3
The attendee can view and interact with the session. The local keyboard and mouse input is redirected to
the session.
CTRL_LEVEL_REQCTRL_VIEW
Value: 4
The attendee can view the session.

Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008 and Windows Vista:  This enumeration value is not supported.
CTRL_LEVEL_REQCTRL_INTERACTIVE
Value: 5
The attendee can view and interact with the session. The local keyboard and mouse input is redirected to the
session. Hosting applications that want to allow users to control the shared session must either define
uiAccess as "true" in their application manifest OR run at High Integrity
Level (elevated). For more information see
Setting UIAccess in the Application Manifest File.

Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008 and Windows Vista:  This enumeration value is not supported.
CTRL_LEVEL_MAX
Value: 5
Maximum enumeration value.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Header rdpencomapi.h

See also

ControlLevel Property of IRDPSRAPIAttendee

IRDPSRAPIViewer::RequestControl

OnControlLevelChangeRequest