Fungsi SpawnDerivedClass

Membuat objek kelas yang baru diturunkan dari objek tertentu.

Catatan

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

Sintaks

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

Parameter

vFunc
[in] Parameter ini tidak digunakan.

ptr
[in] Penunjuk ke instans IWbemClassObject.

lFlags
[in] Dipesan. Parameter ini harus berupa 0.

ppNewClass
[out] Menerima penunjuk ke objek definisi kelas yang baru. Jika terjadi kesalahan, objek baru tidak dikembalikan dan ppNewClass dibiarkan tidak diubah. Nilainya tidak dapat berupa null.

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_FAILED	0x80041001	Telah terjadi kegagalan umum.
WBEM_E_INVALID_OPERATION	0x80041016	Operasi yang tidak valid, seperti memunculkan kelas dari sebuah instans, telah diminta.
WBEM_E_INCOMPLETE_CLASS		Kelas sumber tidak sepenuhnya ditentukan atau terdaftar di Windows Management, sehingga kelas turunan yang baru tidak diizinkan.
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::SpawnDerivedClass.

ptr harus berupa definisi kelas yang menjadi kelas induk dari objek yang dimunculkan. Objek yang dikembalikan menjadi subkelas dari objek saat ini.

Objek baru yang dikembalikan di ppNewClass secara otomatis menjadi subkelas dari 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)