Fungsi SpawnInstance

Membuat instans kelas baru.

Catatan

API ini hanya untuk penggunaan internal. API ini tidak dimaksudkan untuk digunakan dari kode pengembang.

Sintaks

HRESULT SpawnInstance (
   [in] int                  vFunc,
   [in] IWbemClassObject*    ptr,
   [in] LONG                 lFlags,
   [out] IWbemClassObject**  ppNewInstance);

Parameter

vFunc
[in] Parameter ini tidak digunakan.

ptr
[in] Penunjuk ke instans IWbemClassObject.

lFlags
[in] Dipesan. Parameter ini harus 0.

ppNewInstance
[out] Menerima penunjuk ke instans kelas baru. Jika terjadi kesalahan, objek baru tidak ditampilkan, dan ppNewInstance dibiarkan tidak dimodifikasi.

Mengembalikan nilai

Nilai berikut yang dikembalikan oleh fungsi ini ditentukan dalam file header WbemCli.h, atau Anda dapat menentukannya sebagai konstanta dalam kode Anda:

Terus-menerus	Nilai	Deskripsi
WBEM_E_INCOMPLETE_CLASS	0x80041020	ptr bukan definisi kelas yang valid dan tidak dapat menghasilkan instans baru. Ini belum lengkap atau belum terdaftar di Windows Management dengan memanggil PutClassWmi.
WBEM_E_OUT_OF_MEMORY	0x80041006	Tidak cukup memori yang tersedia untuk menyelesaikan operasi.
WBEM_E_INVALID_PARAMETER	0x80041008	ppNewClassadalah null.
WBEM_S_NO_ERROR	0	Panggilan fungsi berhasil.

Keterangan

Fungsi ini membungkus panggilan ke metode IWbemClassObject::SpawnInstance.

ptr harus berupa definisi kelas yang diperoleh dari Windows Management. (Perhatikan bahwa menghasilkan instans dari instans didukung tetapi instans yang ditampilkan kosong.) Anda kemudian menggunakan definisi kelas ini untuk membuat instans baru. Panggilan ke fungsi PutInstanceWmi diperlukan jika Anda ingin menulis instans ke Windows Management.

Objek baru yang ditampilkan di ppNewClass secara otomatis menjadi subkelas objek saat ini. Perilaku ini tidak dapat diganti. Tidak ada metode lain di mana subkelas (kelas turunan) dapat dibuat.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: WMINet_Utils.idl

Versi .NET Framework: Tersedia sejak 4.7.2

Lihat juga

• WMI dan Penghitung Kinerja (Referensi API Tidak Terkelola)