InitiateShutdown method of the Msvm_ShutdownComponent class

發行項
05/31/2018

Initiates an operating system shutdown operation on the associated child virtual machine. If zero (0) is returned, then the shutdown was initiated successfully. Any other return code indicates an error condition.

Syntax

uint32 InitiateShutdown(
  [in] boolean Force,
  [in] string  Reason
);

Parameters

Force [in]

Type: boolean

A flag which, if TRUE, forces applications to be closed despite having unsaved data.

Reason [in]

Type: string

The reason for the shutdown operation. This is a user-defined string.

Return value

Type: uint32

Completed with No Error (0)
Method Parameters Checked - Job Started (4096)
Failed (32768)
Access Denied (32769)
Not Supported (32770)
Status is unknown (32771)
Timeout (32772)
Invalid parameter (32773)
System is in used (32774)
Invalid state for this operation (32775)
Incorrect data type (32776)
System is not available (32777)
Out of memory (32778)
File not found (32779)
The system is not ready (32780)
The machine is locked and cannot be shut down without the force option (32781)
A system shutdown is in progress (32782)

Remarks

Access to the Msvm_ShutdownComponent class might be restricted by UAC Filtering. For more information, see User Account Control and WMI.

Requirements


Minimum supported client	None supported
Minimum supported server	Windows Server 2008
End of client support	None supported
End of server support	Windows Server 2012
Namespace	Root\Virtualization
Header	Winreg.h
MOF	WindowsVirtualization.mof

共用方式為