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]

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

Reason [in]

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

Return Value

Completed with No Error (0)

Method Parameters Checked - JobStarted (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

See Also

Msvm_ShutdownComponent

Send comments about this topic to Microsoft

Build date: 10/8/2009