Msvm_ImageManagementService 類別的 GetVirtualHardDiskSettingData 方法

擷取與虛擬硬碟檔案相關聯的設定資料。

語法

uint32 GetVirtualHardDiskSettingData(
  [in]  string              Path,
  [out] string              SettingData,
  [out] CIM_ConcreteJob REF Job
);

參數

路徑 [in]

磁片映射檔的完整路徑。

SettingData [out]

如果成功，會收到包含虛擬硬碟之設定資料的 Msvm_VirtualHardDiskSettingData 類別內嵌實例。

作業 [out]

如果以非同步方式執行作業，這個方法會傳回 4096，而且此參數會包含衍生自 CIM_ConcreteJob的物件參考。

傳回值

這個方法會傳回下列其中一個值。

已完成 ， (0)

已檢查方法參數 - 作業啟動 (4096)

失敗 (32768)

拒絕存取 (32769)

不支援 (32770)

狀態未知 (32771)

逾 時 (32772)

不正確參數 (32773)

系統正在使用 (32774)

此作業的狀態無效 ， (32775)

不正確的資料類型 (32776)

系統無法使用 (32777)

記憶體不足 (32778)

找不到 檔案 (32779)

備註

Msvm_ImageManagementService 類別的 存取可能會受到 UAC 篩選的限制。 如需詳細資訊，請參閱 使用者帳戶控制和 WMI。

範例

下列 C# 範例示範如何呼叫 GetVirtualHardDiskState 方法。 您可以在 虛擬範例的通用公用程式中找到參考的公用程式， (V2) 。

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

    inParams["Path"] = vhdPath;

    ManagementBaseObject outParams = imageService.InvokeMethod("GetVirtualHardDiskSettingData", inParams, null);
    if ((UInt32)outParams["ReturnValue"] == ReturnCode.Started)
    {
        if (Utility.JobCompleted(outParams, scope))
        {
            Console.WriteLine("GetVirtualHardDiskSettingData was successful.");
        }
        else
        {
            Console.WriteLine("GetVirtualHardDiskSettingData was not successful.");
        }
    }
    else if ((UInt32)outParams["ReturnValue"] == ReturnCode.Completed)
    {
        string diskStateString = outParams["SettingData"].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