다음을 통해 공유


InitiateShutdown method of the Msvm_ShutdownComponent class

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

See also

Msvm_ShutdownComponent