Метод GetVirtualHardDiskState класса Msvm_ImageManagementService

Статья
06/13/2023

Извлекает сведения о состоянии для файла виртуального жесткого диска.

Синтаксис

uint32 GetVirtualHardDiskState(
  [in]  string              Path,
  [out] string              State,
  [out] CIM_ConcreteJob REF Job
);

Параметры

Путь [in]: Полный путь к файлу образа диска.
Состояние [out]: В случае успешного выполнения получает внедренный экземпляр класса Msvm_VirtualHardDiskState , содержащий сведения о состоянии виртуального жесткого диска.
Задание [out]: Если операция выполняется асинхронно, этот метод возвращает значение 4096, а этот параметр будет содержать ссылку на объект, производный от CIM_ConcreteJob.

Возвращаемое значение

Этот метод возвращает одно из следующих значений.

Выполнено без ошибок (0)
Проверенные параметры метода — задание запущено (4096)
Сбой (32768)
Доступ запрещен (32769)
Не поддерживается (32770)
Состояние неизвестно (32771)
Время ожидания (32772)
Недопустимый параметр (32773)
Система используется (32774)
Недопустимое состояние для этой операции (32775)
Неправильный тип данных (32776)
Система недоступна (32777)
Нехватка памяти (32778)
Файл не найден (32779)

Примеры

В следующем примере C# показано, как вызвать метод GetVirtualHardDiskState . Ссылки на служебные программы можно найти в разделе Общие служебные программы для примеров виртуализации (версия 2).

public static void GetVirtualHardDiskState(string vhdPath)
{
    ManagementScope scope = new ManagementScope(@"root\virtualization\V2", null);
    ManagementObject imageService = Utility.GetServiceObject(scope, "Msvm_ImageManagementService");
    ManagementBaseObject inParams = imageService.GetMethodParameters("GetVirtualHardDiskState");

    inParams["Path"] = vhdPath;
    
    ManagementBaseObject outParams = imageService.InvokeMethod("GetVirtualHardDiskState", inParams, null);
    if ((UInt32)outParams["ReturnValue"] == ReturnCode.Started)
    {
        if (Utility.JobCompleted(outParams, scope))
        {
            Console.WriteLine("GetVirtualHardDiskState was successful.");
        }
        else
        {
            Console.WriteLine("GetVirtualHardDiskState was not successful.");
        }
    }
    else if ((UInt32)outParams["ReturnValue"] == ReturnCode.Completed)
    {
        string diskStateString = outParams["State"].ToString();
        Utility.PrintEmbeddedInstance(diskStateString);
    }

    outParams.Dispose();
    inParams.Dispose();
    imageService.Dispose();
}

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Пространство имен	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

См. также раздел

Msvm_ImageManagementService