QualifierSet_BeginEnumeration işlevi

Bir nesnenin niteleyicilerinin bir numaralandırıcısını numaralandırmanın başına sıfırlar.

Not

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

Sözdizimi

HRESULT QualifierSet_BeginEnumeration (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags
);

Parametreler

vFunc
[in] Bu parametre kullanılmadı.

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

lFlags
[in] Numaralandırmaya eklenecek niteleyicileri belirten Açıklamalar bölümünde açıklanan bayrakların veya değerlerin bit düzeyinde birleşimi.

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_INVALID_PARAMETER	0x80041008	lFlags Parametre geçerli değil.
WBEM_E_UNEXPECTED	0x8004101d	öğesine araya girmeden ikinci QualifierSet_BeginEnumeration bir çağrısı QualifierSet_EndEnumerationyapıldı.
WBEM_E_OUT_OF_MEMORY	0x80041006	Yeni bir sabit listesi başlatmak için yeterli bellek yok.
WBEM_S_NO_ERROR	0	İşlev çağrısı başarılı oldu.

Açıklamalar

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

Bir nesnedeki tüm niteleyicileri listelemek için, QualifierSet_Next ilk çağrıdan önce bu yöntem çağrılmalıdır. Niteleyicilerin numaralandırıldığı sıra, belirli bir sabit listesi için sabit olarak garanti edilir.

Bağımsız değişken olarak lEnumFlags geçirilebilen bayraklar WbemCli.h üst bilgi dosyasında tanımlanır veya bunları kodunuzda sabit olarak tanımlayabilirsiniz.

Sabit	Değer	Açıklama
	0	Tüm niteleyicilerin adlarını döndürür.
WBEM_FLAG_LOCAL_ONLY	0x10	Yalnızca geçerli özelliğe veya nesneye özgü niteleyicilerin adlarını döndürür. Bir özellik için: Sınıf tanımından yayılan niteleyicileri değil, yalnızca özelliğe özgü niteleyicileri (geçersiz kılmalar dahil) döndürür. Bir örnek için: Yalnızca örneğe özgü niteleyici adlarını döndürür. Bir sınıf için: Yalnızca türetilen sınıfa özgü niteleyicileri döndürür.
WBEM_FLAG_PROPAGATED_ONLY	0x20	Yalnızca başka bir nesneden yayılan niteleyicilerin adlarını döndürür. Bir özellik için: Yalnızca sınıf tanımından bu özelliğe yayılan niteleyicileri döndürür, özelliğin kendisinden gelenleri döndürmez. Bir örnek için: Yalnızca sınıf tanımından yayılan niteleyicileri döndürür. Bir sınıf için: Yalnızca üst sınıflardan devralınan niteleyici adlarını döndürür.

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)