CWbemProviderGlue::GetEmptyInstance(MethodContext*,LPCWSTR,CInstance**,LPCWSTR) metode (wbemglue.h)

[Kelas CWbemProviderGlue adalah bagian dari Kerangka Kerja Penyedia WMI yang sekarang dipertimbangkan dalam keadaan akhir, dan tidak ada pengembangan, peningkatan, atau pembaruan lebih lanjut yang akan tersedia untuk masalah terkait non-keamanan yang memengaruhi pustaka ini. API MI harus digunakan untuk semua pengembangan baru.]

Metode GetEmptyInstance mengambil satu instans yang tidak diisi dari kelas yang ditentukan.

Sintaks

HRESULT GetEmptyInstance(
  MethodContext *pMethodContext,
  LPCWSTR       pszClassName,
  CInstance     **ppInstance,
  LPCWSTR       pszNamespace
);

Parameter

pMethodContext

Arahkan ke konteks saat ini.

pszClassName

Nama kelas yang instansnya akan dikembalikan.

ppInstance

Arahkan ke instans kelas CInstance yang digunakan untuk menyimpan instans baru. Pointer ini harus dirilis oleh penyedia kerangka kerja yang memanggil GetEmptyInstance.

pszNamespace

Namespace layanan nama kelas yang ditentukan oleh pszClassName. Parameter ini dapat berupa NULL untuk menunjukkan namespace default, yaitu root\cimv2.

Mengembalikan nilai

Mengembalikan WBEM_S_NO_ERROR jika operasi berhasil, WBEM_E_OUT_OF_MEMORY jika operasi gagal karena kurangnya memori, atau kode kesalahan HRESULT lainnya.

Keterangan

Penyedia kerangka kerja meneruskan nama penyedia ke GetEmptyInstance, yang mengembalikan instans kosong. Penggunaan umum metode ini adalah mengisi properti objek yang disematkan. Metode ini digunakan bersama dengan CInstance::SetEmbeddedObject.

Prototipe fungsi kedua tidak disarankan. Ini disediakan hanya untuk mendukung kode yang ada.

Persyaratan

Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	wbemglue.h (termasuk FwCommon.h)
Pustaka	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll