QualifierSet_Next işlevi

QualifierSet_BeginEnumeration işlevi çağrısıyla başlayan bir numaralandırmada sonraki niteleyiciyi alır.

Not

Bu API yalnızca iç kullanıma yöneliktir. Geliştirici kodundan kullanılmak üzere tasarlanmamıştır.

Sözdizimi

HRESULT QualifierSet_Next (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] BSTR*               pstrName,
   [out] VARIANT*            pVal,
   [out] LONG*               plFlavor
);

Parametreler

vFunc [in] Bu parametre kullanılmadı.

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

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

pstrName [out] Niteleyicinin adı. ise null, bu parametre yoksayılır; aksi takdirde geçerli pstrNameBSTR bir bellek sızıntısına işaret etmemelidir. Null değilse, işlevi döndürdüğünde WBEM_S_NO_ERRORher zaman yeni BSTR bir ayırır.

pVal [out] Başarılı olduğunda, niteleyicinin değeri. İşlev başarısız olursa, VARIANT ile işaret edilen pVal değiştirilmez. Bu parametre ise nullparametresi yoksayılır.

plFlavor [out] Niteleyici türünü alan long işaretçisi. Lezzet bilgileri istenmiyorsa, bu parametre olabilir null.

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	Parametre geçerli değil.
WBEM_E_UNEXPECTED	0x8004101d	Arayan QualifierSet_BeginEnumeration çağırmadı.
WBEM_E_OUT_OF_MEMORY	0x80041006	Yeni bir sabit listesi başlatmak için yeterli bellek yok.
WBEM_S_NO_MORE_DATA	0x40005	Numaralandırmada başka niteleyici kalmadı.
WBEM_S_NO_ERROR	0	İşlev çağrısı başarılı oldu.

Açıklamalar

Bu işlev bir çağrıyı IWbemQualifierSet::Next yöntemine sarmalar.

İşlev döndürülene QualifierSet_NextWBEM_S_NO_MORE_DATAkadar tüm niteleyicileri listelemek için işlevini art arda çağırırsınız. Numaralandırmayı erken sonlandırmak için QualifierSet_EndEnumeration işlevini çağırın.

Numaralandırma sırasında döndürülen niteleyicilerin sırası tanımsız.

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)