Sonraki işlev

BeginEnumeration çağrısıyla başlayan bir numaralandırmada sonraki özelliği alır.

Not

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

Sözdizimi

HRESULT Next (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              lFlags,
   [out] BSTR*            pstrName,
   [out] VARIANT*         pVal,
   [out] CIMTYPE*         pvtType,
   [out] LONG*            plFlavor
);

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.

pstrName
[out] Özellik adını içeren yeni BSTR bir. Ad gerekli değilse bu parametreyi null olarak ayarlayabilirsiniz.

pVal
[out] VARIANT Özelliğin değeriyle doldurulmuş. Değer gerekli değilse bu parametreyi null olarak ayarlayabilirsiniz. İşlev bir hata kodu döndürürse, VARIANT geçirilen pVal yerine getirilmemiş olarak bırakılır.

pvtType
[out] Bir CIMTYPE değişkenin işaretçisi ( LONG özelliğin türünün yerleştirildiği bir). Bu özelliğin değeri bir VT_NULL_VARIANTolabilir, bu durumda özelliğin gerçek türünü belirlemek gerekir. Bu parametre de olabilir null.

plFlavor
[out] nullveya özelliğin kaynağı hakkında bilgi alan bir değer. Olası değerler için [Açıklamalar] bölümüne bakın.

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_FAILED	0x80041001	Genel bir hata oluştu.
WBEM_E_INVALID_PARAMETER	0x80041008	Parametre geçersiz.
WBEM_E_UNEXPECTED	0x8004101d	İşleve BeginEnumeration çağrı yapılmadı.
WBEM_E_OUT_OF_MEMORY	0x80041006	Yeni bir sabit listesi başlatmak için yeterli bellek yok.
WBEM_E_TRANSPORT_FAILURE	0x80041015	Geçerli işlem ile Windows Yönetimi arasındaki uzak yordam çağrısı başarısız oldu.
WBEM_S_NO_ERROR	0	İşlev çağrısı başarılı oldu.
WBEM_S_NO_MORE_DATA	0x40005	Numaralandırmada başka özellik yok.

Açıklamalar

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

Bu yöntem sistem özelliklerini de döndürür.

Özelliğin temel türü bir nesne yolu, tarih veya saat ya da başka bir özel türse, döndürülen tür yeterli bilgi içermez. Çağıranın, özelliğin bir nesne başvurusu, tarih veya saat ya da başka bir özel tür olup olmadığını belirlemek için belirtilen özelliğin öğesini incelemesi CIMTYPE gerekir.

değilse plFlavornullLONG, değer aşağıdaki gibi özelliğin kaynağı hakkında bilgi alır:

Sabit	Değer	Açıklama
WBEM_FLAVOR_ORIGIN_SYSTEM	0x40	özelliği standart bir sistem özelliğidir.
WBEM_FLAVOR_ORIGIN_PROPAGATED	0x20	Bir sınıf için: özelliği üst sınıftan devralınır. Bir örnek için: Üst sınıftan devralınan özelliği, örnek tarafından değiştirilmemiştir.
WBEM_FLAVOR_ORIGIN_LOCAL	0	Bir sınıf için: özelliği türetilmiş sınıfa aittir. Bir örnek için: özelliği örnek tarafından değiştirilir; başka bir ifadeyle, bir değer sağlandı veya bir niteleyici eklendi veya değiştirildi.

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)