SpawnInstance işlevi

Sınıfın yeni bir örneğini oluşturur.

Not

Bu API yalnızca dahili kullanım içindir. Geliştirici kodundan kullanıma yönelik değildir.

Sözdizimi

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

Parametreler

vFunc
[in] Bu parametre kullanılmadı.

ptr
[in] IWbemClassObject örneğinin işaretçisi .

lFlags
[in] Saklı -dır. Bu parametre 0 olmalıdır.

ppNewInstance
[out] sınıfının yeni örneğinin işaretçisini alır. Hata oluşursa, yeni bir nesne döndürülür ve ppNewInstance değiştirilmez.

Döndürülen değer

Bu işlev tarafından döndürülen aşağıdaki değerler WbemCli.h üst bilgi dosyasında tanımlanır veya bunları kodunuzda sabit olarak tanımlayabilirsiniz:

Sabit	Değer	Açıklama
WBEM_E_INCOMPLETE_CLASS	0x80041020	ptr geçerli bir sınıf tanımı değildir ve yeni örnekler oluşturamaz. Eksik veya PutClassWmi çağrılarak Windows Yönetimi'ne kaydedilmemiş.
WBEM_E_OUT_OF_MEMORY	0x80041006	İşlemi tamamlamak için yeterli bellek yok.
WBEM_E_INVALID_PARAMETER	0x80041008	ppNewClass, null değeridir.
WBEM_S_NO_ERROR	0	İşlev çağrısı başarılı oldu.

Açıklamalar

Bu işlev , IWbemClassObject::SpawnInstance yöntemine yapılan çağrıyı sarmalar.

ptr , Windows Yönetimi'nden alınan bir sınıf tanımı olmalıdır. (Örnekten örnek oluşturmanın desteklendiğini ancak döndürülen örneğin boş olduğunu unutmayın.) Ardından yeni örnekler oluşturmak için bu sınıf tanımını kullanırsınız. Örneği Windows Yönetimi'ne yazmak istiyorsanız PutInstanceWmi işlevine bir çağrı yapılması gerekir.

içinde ppNewClass döndürülen yeni nesne otomatik olarak geçerli nesnenin alt sınıfına dönüşür. Bu davranış geçersiz kılınamaz. Alt sınıfların (türetilmiş sınıflar) oluşturulabileceği başka bir yöntem yoktur.

Gereksinimler

Platform: Bkz. Sistem Gereksinimleri.

Üstbilgi: WMINet_Utils.idl

.NET Framework Sürümleri: 4.7.2 sürümünden itibaren kullanılabilir

Ayrıca bkz.

• WMI ve Performans Sayaçları (Yönetilmeyen API Başvurusu)