Returns virtual machine summary information for the specified virtual machine definition files.
Syntax
uint32 GetDefinitionFileSummaryInformation(
[in] string DefinitionFiles[],
[out] Msvm_SummaryInformationBase SummaryInformation[]
);
Parameters
DefinitionFiles [in]
An array of paths to XML configuration files for which to return summary information.
SummaryInformation [out]
An array of Msvm_SummaryInformationBase instances containing the requested information for the virtual machines and/or snapshots specified in the DefinitionFiles array. Only the Name, ElementName, CreationTime, and Notes properties are returned, all other properties will be Null.
Note:
Prior to Windows 10, version 1703, datatype was Msvm_SummaryInformation.
Return value
This method returns one of the following values.
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 use (32774)
Invalid state for this operation (32775)
Incorrect data type (32776)
System is not available (32777)
Out of memory (32778)
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
Msvm_VirtualSystemManagementService
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.
