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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8 [desktop apps only] |
| Minimum supported server | Windows Server 2012 [desktop apps only] |
| Namespace | Root\Virtualization\V2 |
| MOF | WindowsVirtualization.V2.mof |
| DLL | Vmms.exe |
See also
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
