Metode IWbemServices::D eleteInstance (wbemcli.h)

Metode IWbemServices::D eleteInstance menghapus instans kelas yang ada di namespace saat ini.

Sintaks

HRESULT DeleteInstance(
  [in]  const BSTR      strObjectPath,
  [in]  long            lFlags,
  [in]  IWbemContext    *pCtx,
  [out] IWbemCallResult **ppCallResult
);

Parameter

[in] strObjectPath

BSTR valid yang berisi jalur objek ke instans yang akan dihapus.

[in] lFlags

Salah satu nilai berikut ini valid.

WBEM_FLAG_RETURN_IMMEDIATELY

Bendera ini menyebabkan ini menjadi panggilan semisinkron. Untuk informasi selengkapnya, lihat Memanggil Metode.

[in] pCtx

Biasanya NULL. Jika tidak, ini adalah penunjuk ke objek IWbemContext yang dapat digunakan oleh penyedia yang menghapus instans. Nilai dalam objek konteks harus ditentukan dalam dokumentasi untuk penyedia yang bersangkutan.

[out] ppCallResult

Jika NULL, parameter ini tidak digunakan. Jika ppCallResult ditentukan, ppCallResult harus diatur untuk menunjuk ke NULL pada entri. Jika parameter lFlags berisi WBEM_FLAG_RETURN_IMMEDIATELY, panggilan ini segera kembali dengan WBEM_S_NO_ERROR. Parameter ppCallResult menerima pointer ke objek IWbemCallResult baru, yang kemudian dapat dijajaki untuk mendapatkan hasilnya menggunakan metode GetCallStatus .

Nilai kembali

Metode ini mengembalikan HRESULT yang menunjukkan status panggilan metode. Daftar berikut mencantumkan nilai yang terkandung dalam HRESULT.

Jika gagal, Anda dapat memperoleh informasi apa pun yang tersedia dari fungsi COM GetErrorInfo.

Kode kesalahan khusus COM juga dapat dikembalikan jika masalah jaringan menyebabkan Anda kehilangan koneksi jarak jauh ke Manajemen Windows.

Keterangan

Metode IWbemServices::D eleteInstance dipanggil untuk menghapus instans yang ada di namespace saat ini. Instans di namespace lain tidak dapat dihapus. Ketika DeleteInstance dipanggil untuk menghapus instans yang termasuk dalam kelas dalam hierarki, Manajemen Windows memanggil metode DeleteInstanceAsync untuk semua penyedia yang bertanggung jawab atas kelas non-abstrak dalam hierarki. Artinya, jika parameter strObjectPath mengidentifikasi instans ClassB, dan ClassB berasal dari ClassA, kelas non-abstrak, dan merupakan kelas induk ClassC dan ClassD, juga kelas non-abstrak, penyedia untuk keempat kelas dipanggil.

Manajemen Windows memanggil setiap penyedia dengan jalur objek yang dimodifikasi untuk menunjuk ke kelas mereka. Misalnya, jika strObjectPath untuk panggilan asli diatur ke "ClassB.k=1", panggilan ke penyedia ClassA akan mengatur strObjectPath ke "ClassA.k=1".

Keberhasilan panggilan DeleteInstance hanya bergantung pada keberhasilan panggilan DeleteInstanceAsync ke penyedia kelas non-abstrak teratas. Kelas non-abstrak memiliki kelas abstrak sebagai induknya. Jika penyedia untuk salah satu kelas tersebut berhasil, operasi berhasil; jika semua kelas tersebut gagal, operasi gagal.

Misalnya, asumsikan bahwa ClassX adalah kelas dasar untuk hierarki berikut:

1. ClassA berasal dari ClassX.
2. ClassB berasal dari ClassA.
3. ClassC dan ClassD berasal dari ClassB.

Jika ClassX adalah satu-satunya kelas abstrak dalam hierarki dan parameter strObjectPath di DeleteInstance menunjuk ke instans ClassB, hanya penyedia untuk ClassA yang perlu berhasil dalam panggilan DeleteInstanceAsync-nya .

Jika ClassX, ClassA, dan ClassB semuanya abstrak dan parameter strObjectPath di DeleteInstance kembali menunjuk ke instans ClassB, baik penyedia untuk ClassC atau penyedia untuk ClassD harus berhasil.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	wbemcli.h (termasuk Wbemidl.h)
Pustaka	Wbemuuid.lib
DLL	Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll

Lihat juga

Menjelaskan Jalur Objek Instans

IWbemCallResult

IWbemServices

IWbemServices::D eleteInstanceAsync

Mengambil Kode Kesalahan