GetNames işlevi

Bir nesnenin özelliklerinin bir alt kümesini veya tüm 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 GetNames (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszQualifierName,
   [in] LONG                lFlags,
   [in] VARIANT*            pQualifierValue,
   [out] SAFEARRAY (BSTR)** pstrNames
);

Parametreler

vFunc
[in] Bu parametre kullanılmadı.

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

wszQualifierName
[in] Filtrenin parçası olarak çalışan bir niteleyici adı belirten geçerli LPCWSTR bir işaretçi. Daha fazla bilgi için Açıklamalar bölümüne bakın. Bu parametre olabilir null.

lFlags
[in] Bit alanlarının birleşimi. Daha fazla bilgi için Açıklamalar bölümüne bakın.

pQualifierValue [in] Filtre değerine başlatılan geçerli VARIANT bir yapıya işaret eden bir işaretçi. Bu parametre olabilir null.

pstrNames
[out] SAFEARRAY Özellik adlarını içeren bir yapı. Girişte, bu parametre her zaman için nullbir işaretçi olmalıdır. Daha fazla bilgi 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	Bir veya daha fazla parametre geçerli değil veya bayraklarla parametrelerin yanlış birleşimi belirtildi.
WBEM_E_OUT_OF_MEMORY	0x80041006	İşlemi tamamlamak 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ı IWbemClassObject::GetNames yöntemine sarmalar .

Döndürülen adlandırılmış bayraklar ve parametrelerin bir bileşimi tarafından denetlenmektedir. Örneğin, işlev tüm özelliklerin adlarını veya yalnızca anahtar özelliklerin adlarını döndürebilir. Birincil filtre parametresinde lFlags belirtilir ve diğer parametreler buna bağlı olarak değişir.

içindeki lFlags bayrak değerleri bit alanlarıdır

Bağımsız değişken olarak lEnumFlags geçirilebilen bayraklar , WbemCli.h üst bilgi dosyasında tanımlanan bit alanlarıdı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 bayrakları	Değer	Açıklama
WBEM_FLAG_ALWAYS	0	Tüm özellik adlarını döndürür. strQualifierName ve pQualifierVal kullanılmamış.
WBEM_FLAG_ONLY_IF_TRUE	1	Yalnızca parametresi tarafından strQualifierName belirtilen adın niteleyicisine sahip özellikleri döndürür. Bu bayrak kullanılıyorsa belirtmelisiniz strQualifierName.
WBEM_FLAG_ONLY_IF_FALSE	2	Yalnızca parametresi tarafından strQualifierName belirtilen adın niteleyicisine sahip olmayan özellikleri döndürür. Bu bayrak kullanılıyorsa belirtmelisiniz strQualifierName.
WBEM_FLAG_ONLY_IF_IDENTICAL	3	Yalnızca parametresi tarafından belirtilen adın niteleyicisine sahip olan ve yapı tarafından wszQualifierName belirtilen pQualifierVal değerle aynı değere sahip olan özellikleri döndürür. Bu bayrak kullanılıyorsa, hem pQualifierValuehem wszQualifierName de belirtmelisiniz.

Grup 2 bayrakları	Değer	Açıklama
WBEM_FLAG_KEYS_ONLY	0x4	Yalnızca anahtarları tanımlayan özelliklerin adlarını döndürür.
WBEM_FLAG_REFS_ONLY	0x8	Yalnızca nesne başvurusu olan özellik adlarını döndürür.

Grup 3 bayrakları	Değer	Açıklama
WBEM_FLAG_LOCAL_ONLY	0x10	Yalnızca en türetilmiş sınıfa ait özellik adlarını döndürür. Özellikleri üst sınıfların dışında tutun.
WBEM_FLAG_PROPAGATED_ONLY	0x20	Yalnızca üst sınıflara ait özellik adlarını döndürür.
WBEM_FLAG_SYSTEM_ONLY	0x30	Yalnızca sistem özelliklerinin adlarını döndürür.
WBEM_FLAG_NONSYSTEM_ONLY	0x40	Yalnızca sistem dışı özelliklerin adlarını döndürür.

İşlev, döndürürse WBEM_S_NO_ERRORher zaman yeni SAFEARRAY bir ayırır ve pstrNames her zaman bunu işaret etmek için ayarlanır. Belirtilen filtrelerle eşleşen bir özellik yoksa, döndürülen dizi 0 öğeye sahip olabilir. İşlev dışında WBM_S_NO_ERRORbir değer döndürürse, yeni SAFEARRAY bir yapı döndürülü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)