Get işlevi

Varsa belirtilen özellik değerini alır.

Not

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

Sözdizimi

HRESULT Get (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LPCWSTR           wszName,
   [in] LONG              lFlags,
   [out] VARIANT*         pVal,
   [out] CIMTYPE*         pvtType,
   [out] LONG*            plFlavor
);

Parametreler

vFunc
[in] Bu parametre kullanılmadı.

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

wszName
[in] Özelliğin adı.

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

pVal
[out] İşlev başarıyla döndürülüyorsa, özelliğinin wszName değerini içerir. pval Bağımsız değişkene niteleyici için doğru tür ve değer atanır.

pvtType
[out] İşlev başarıyla döndürülüyorsa, özellik türünü gösteren CIM türünde bir sabit içerir. Değeri de olabilir null.

plFlavor
[out] İşlev başarıyla döndürülüyorsa, özelliğin kaynağı hakkında bilgi alır. Değeri olabilir veya WbemCli.h üst bilgi dosyasında tanımlanan aşağıdaki WBEM_FLAVOR_TYPE sabitlerinden biri olabilirnull:

Sabit	Değer	Açıklama
WBEM_FLAVOR_ORIGIN_SYSTEM	0x40	özelliği standart bir sistem özelliğidir.
WBEM_FLAVOR_ORIGIN_PROPAGATED	0x20	Bir sınıf için: özelliği üst sınıftan devralınır. Bir örnek için: Üst sınıftan devralınan özelliği, örnek tarafından değiştirilmedi.
WBEM_FLAVOR_ORIGIN_LOCAL	0	Bir sınıf için: özelliği türetilmiş sınıfa aittir. Bir örnek için: özelliği örnek tarafından değiştirilir; başka bir ifadeyle bir değer sağlandı veya bir niteleyici eklendi veya değiştirildi.

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.
WBEM_E_NOT_FOUND	0x80041002	Belirtilen özellik bulunamadı.
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::Get yöntemine sarmalar.

Get işlevi sistem özelliklerini de döndürebilir.

pVal Bağımsız değişkene niteleyici ve COM VariantInit işlevi için doğru tür ve değer atanı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)