Edit

GetVHDSnapshotInformation method of the Msvm_ImageManagementService class

  • Article

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

Msvm_ImageManagementService