QualifierSet_GetNames işlevi

Geçerli nesne veya özellikten kullanılabilen tüm niteleyicilerin veya belirli niteleyicilerin adlarını 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_GetNames (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] SAFEARRAY (BSTR)**  pstrNames
);

Parametreler

vFunc
[in] Bu parametre kullanılmadı.

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

lFlags
[in] Numaralandırmaya eklenecek adları belirten aşağıdaki bayraklardan veya değerlerden biri.

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. Örnek için: Yalnızca örneğe özgü niteleyici adlarını döndürür. 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. Sınıf için: Yalnızca üst sınıflardan devralınan niteleyici adları döndürür.

pstrNames
[out] İstenen adları içeren yeni SAFEARRAY bir. Dizide 0 öğe olabilir. Hata oluşursa yeni SAFEARRAY bir sonuç döndürülmedi.

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_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 bir çağrıyı IWbemQualifierSet::GetNames yöntemine sarmalar .

Niteleyici adlarını aldıktan sonra, QualifierSet_Get işlevini çağırarak her niteleyiciye ada göre erişebilirsiniz.

Belirli bir nesnenin sıfır niteleyiciye sahip olması hata değildir, bu nedenle işlevi döndürse WBEM_S_NO_ERRORbile döndürülen dizelerin pstrNames sayısı 0 olabilir.

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)