Retrieves information about a VHD Snapshot within a VHD Set file.
Syntax
uint32 GetVHDSnapshotInformation(
[in] string VHDSetPath,
[in] string SnapshotIds[],
[in] uint32 AdditionalInformation[],
[out] string SnapshotInformation[],
[out] CIM_ConcreteJob REF Job
);
Parameters
VHDSetPath [in]
A fully-qualified path that specifies the location of the VHD Set file.
SnapshotIds [in]
A list of GUIDs representing the Snapshot Ids of each Snapshot for which information is being requested. If this parameter is NULL, information for all Snapshots will be retrieved.
AdditionalInformation [in]
An array specifying what additional information should be gathered about each VHD Snapshot. Each entry in the array is a type of additional information. If this parameter is NULL, no additional information will be retrieved.
Unknown (0)
Other (1)
Parent Paths (2)
SnapshotInformation [out]
If successful, an array of information about each requested snapshot. Each element is an embedded instance of Msvm_VHDSnapshotInformation.
Job [out]
A reference to the job (can be null if the task is completed).
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)
File not found (32779)
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10 [desktop apps only] |
| Minimum supported server | Windows Server 2016 |
| 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.
