Metode GetVirtualHardDiskSettingData dari kelas Msvm_ImageManagementService

Mengambil data pengaturan yang terkait dengan file hard disk virtual.

Sintaks

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

Parameter

Jalur [in]

Jalur file gambar disk yang sepenuhnya memenuhi syarat.

SettingData [out]

Jika berhasil, menerima instans yang disematkan dari kelas Msvm_VirtualHardDiskSettingData yang berisi data pengaturan untuk hard disk virtual.

Job [out]

Jika operasi dilakukan secara asinkron, metode ini akan mengembalikan 4096, dan parameter ini akan berisi referensi ke objek yang berasal dari CIM_ConcreteJob.

Menampilkan nilai

Metode ini mengembalikan salah satu nilai berikut.

Selesai tanpa Kesalahan (0)

Parameter Metode Diperiksa - Pekerjaan Dimulai (4096)

Gagal (32768)

Akses Ditolak (32769)

Tidak Didukung (32770)

Status tidak diketahui (32771)

Batas waktu (32772)

Parameter tidak valid (32773)

Sistem sedang digunakan (32774)

Status tidak valid untuk operasi ini (32775)

Tipe data salah (32776)

Sistem tidak tersedia (32777)

Kehabisan memori (32778)

File tidak ditemukan (32779)

Keterangan

Akses ke kelas Msvm_ImageManagementService mungkin dibatasi oleh Pemfilteran UAC. Untuk informasi selengkapnya, lihat Kontrol Akun Pengguna dan WMI.

Contoh

Contoh C# berikut menunjukkan cara memanggil metode GetVirtualHardDiskState . Utilitas yang dirujuk dapat ditemukan di Utilitas umum untuk sampel virtualisasi (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();
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Ruang nama	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Lihat juga

Msvm_ImageManagementService