Metode IVMGuestOS::Shutdown

Artikel
06/13/2023

[Windows Virtual PC tidak lagi tersedia untuk digunakan pada Windows 8. Sebagai gantinya, gunakan penyedia Hyper-V WMI (V2).]

Mematikan sistem operasi tamu di komputer virtual (VM).

Sintaks

HRESULT Shutdown(
  [in]          VARIANT_BOOL isForced,
  [out, retval] IVMTask      **outShutdownTask
);

Parameter

isForced [in]: VARIANT_TRUE jika pematian harus dipaksakan, VARIANT_FALSE sebaliknya.
outShutdownTask [out, retval]: Objek IVMTask yang digunakan untuk melacak penyelesaian proses pematian.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Mengembalikan kode/nilai	Deskripsi
S_OK 0	Operasi berhasil.
E_POINTER 0x80004003	Parameter outShutdownTask adalah NULL.
VM_E_TIMED_OUT 0xA0040202	Operasi tidak selesai tepat waktu.
VM_E_VM_UNKNOWN 0xA0040207	VM tidak dapat ditemukan.
VM_E_VM_NOT_RUNNING 0xA0040206	VM harus berjalan untuk operasi ini.
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) 0x80070005	Pemanggil harus memiliki izin akses eksekusi untuk VM ini.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL 0xA0040505	Fitur komponen integrasi tidak diinstal di VM ini.
DISP_E_EXCEPTION 0x80020009	Terjadi kesalahan tidak terduga.

Keterangan

VM harus berjalan dan fitur komponen integrasi harus diinstal ketika metode ini dipanggil. Metode ini hanya didukung untuk sistem operasi tamu berbasis Windows.

Nilai berikut dapat dikembalikan melalui properti Kesalahan dari objek IVMTask yang dikembalikan.

Kode kesalahan /Nilai	Deskripsi
`HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED)` (0x80070005)	Pemanggil harus memiliki izin akses eksekusi untuk VM ini.
`HRESULT_FROM_WIN32(ERROR_MACHINE_LOCKED)` (0x800704f7)	Komputer terkunci dan tidak dapat dimatikan tanpa opsi paksa.
`HRESULT_FROM_WIN32(ERROR_NOT_READY)` (0x80070015)	Perangkat belum siap.
`HRESULT_FROM_WIN32(ERROR_SHUTDOWN_IN_PROGRESS)` (0x8007045b)	Pematian sistem sedang berlangsung.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Akhir dukungan klien	Windows 7
Produk	Windows Virtual PC
Header	VPCCOMInterfaces.h
IID	IID_IVMGuestOS didefinisikan sebagai 99fea0db-4880-499a-b6d8-73dff9bc91be

Lihat juga

IVMGuestOS

Bagikan melalui