BeginEnumeration işlevi

Bir numaralandırıcıyı numaralandırmanın başına geri 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 BeginEnumeration (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              lEnumFlags
);

Parametreler

vFunc
[in] Bu parametre kullanılmadı.

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

lEnumFlags
[in] Numaralandırmaya dahil edilen özellikleri denetleyen 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	içindeki lEnumFlags bayrakların birleşimi geçersiz veya geçersiz bir bağımsız değişken belirtildi.
WBEM_E_UNEXPECTED	0x8004101d	öğesine araya girmeden ikinci BeginEnumeration bir çağrısı 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 , IWbemClassObject::BeginEnumeration yöntemine yapılan çağrıyı sarmalar.

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. Her gruptaki bir bayrağı başka bir gruptaki herhangi bir bayrakla birleştirebilirsiniz. Ancak, aynı gruptaki bayraklar birbirini dışlar.

Grup 1

Sabit	Değer	Açıklama
WBEM_FLAG_KEYS_ONLY	0x4	Yalnızca anahtarı oluşturan özellikleri ekleyin.
WBEM_FLAG_REFS_ONLY	0x8	Yalnızca nesne başvuruları olan özellikleri ekleyin.

Grup 2

Sabit	Değer	Açıklama
WBEM_FLAG_SYSTEM_ONLY	0x30	Numaralandırmayı yalnızca sistem özellikleriyle sınırlayın.
WBEM_FLAG_NONSYSTEM_ONLY	0x40	Yerel ve yayılan özellikleri dahil edin, ancak sistem özelliklerini numaralandırmanın dışında tutun.

Sınıflar için:

Sabit	Değer	Açıklama
WBEM_FLAG_CLASS_OVERRIDES_ONLY	0x100	Numaralandırmayı sınıf tanımında geçersiz kılınan özelliklerle sınırlayın.
WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES	0x100	Numaralandırmayı geçerli sınıf tanımında geçersiz kılınan özelliklerle ve sınıfında tanımlanan yeni özelliklerle sınırlayın.
WBEM_MASK_CLASS_CONDITION	0x300	Bir değere uygulanacak lEnumFlags bir maske (bayrak yerine) veya WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES ayarlı olup olmadığını WBEM_FLAG_CLASS_OVERRIDES_ONLY denetler.
WBEM_FLAG_LOCAL_ONLY	0x10	Numaralandırmayı sınıfın kendisinde tanımlanan veya değiştirilen özelliklerle sınırlayın.
WBEM_FLAG_PROPAGATED_ONLY	0x20	Numaralandırmayı temel sınıflardan devralınan özelliklerle sınırlayın.

Örnekler için:

Sabit	Değer	Açıklama
WBEM_FLAG_LOCAL_ONLY	0x10	Numaralandırmayı sınıfın kendisinde tanımlanan veya değiştirilen özelliklerle sınırlayın.
WBEM_FLAG_PROPAGATED_ONLY	0x20	Numaralandırmayı temel sınıflardan devralınan özelliklerle sınırlayın.

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)