GrantInteractiveSessionAccess method of the Msvm_TerminalService class

Grants access to the interactive session of the virtual machine to the specified list of trustees.

Syntax

uint32 GrantInteractiveSessionAccess(
  [in]  CIM_ComputerSystem REF ComputerSystem,
  [in]  string                 Trustees[],
  [out] CIM_ConcreteJob    REF Job
);

Parameters

ComputerSystem [in]

A reference to an instance of the Msvm_ComputerSystem class that represents the virtual machine to which access will be granted.

Trustees [in]

An array of strings, each identifying a trustee that will be granted access to the interactive session of the virtual machine. The trustee identifiers should be specified in Windows SAM-compatible format or Windows SID string format.

Job [out]

If the operation is performed asynchronously, this method will return 4096, and this parameter will contain a reference to an object derived from CIM_ConcreteJob.

Return value

This method returns one of the following values.

Completed with No Error (0)

Not Supported (1)

Failed (2)

Timeout (3)

Invalid Parameter (4)

Invalid State (5)

Incompatible Parameters (6)

DMTF Reserved (..)

Method Parameters Checked - Job Started (4096)

Method Reserved (4097..32767)

Vendor Specific (32768..65535)

Requirements

See also

Msvm_TerminalService