QualifierSet_Put işlevi

Adlandırılmış niteleyiciyi ve değeri yazar. Yeni niteleyici aynı adın önceki değerinin üzerine yazar. Niteleyici yoksa oluşturulur.

Uyarı

Bu API yalnızca iç kullanıma yöneliktir. Geliştirici kodundan kullanıma yönelik değildir.

Sözdizimi

HRESULT QualifierSet_Put (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LPCWSTR              wszName,
   [in] VARIANT*             pVal,
   [in] LONG                 lFlavor
);

Parametreler

vFunc
[in] Bu parametre kullanılmadı.

ptr
[in] IWbemQualifierSet örneğine yönelik bir işaretçi.

wszName
[in] Yazacak niteleyicinin adı.

pVal
[in] Yazacak niteleyiciyi içeren geçerli VARIANT bir işaretçi. Bu parametre olamaz null.

lFlavor
[in] Bu niteleyici için istenen niteleyici tatlarını tanımlayan aşağıdaki sabitlerden biri. Varsayılan değer (0) değeridir WBEM_FLAVOR_OVERRIDABLE .

Sabit	Değer	Description
WBEM_FLAVOR_OVERRIDABLE	0	Niteleyici türetilmiş bir sınıfta veya örnekte geçersiz kılınabilir. Bu varsayılan değerdir.
WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE	1	Niteleyici örneklere yayılır.
WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS	2	Niteleyici türetilmiş sınıflara yayılır.
WBEM_FLAVOR_NOT_OVERRIDABLE	0x10	Niteleyici türetilmiş bir sınıfta veya örnekte geçersiz kılınamaz.
WBEM_FLAVOR_AMENDED	0x80	Niteleyici yerelleştirilmiştir.

Dönüş değeri

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	Description
WBEM_E_CANNOT_BE_KEY	0x8004101f	Anahtar olamayan bir özellikte niteleyiciyi belirtmeye Key yönelik geçersiz bir girişim yapıldı. Anahtarlar bir nesne için sınıf tanımında belirtilir ve örnek temelinde değiştirilemez.
WBEM_E_INVALID_PARAMETER	0x80041008	Parametre geçerli değil.
WBEM_E_INVALID_QUALIFIER_TYPE	0x80041029	pVal parametresi yasal niteleyici türünde değil.
WBEM_E_OVERRIDE_NOT_ALLOWED	0x8004101a	Sahip olan nesne geçersiz kılmalara izin vermediğinden, niteleyicide yöntemini çağırmak QualifierSet_Put mümkün değildir.
WBEM_S_NO_ERROR	0	İşlev çağrısı başarılı oldu.

Açıklamalar

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

Gereksinimler

Platform: Bkz. Sistem Gereksinimleri.

Üstbilgi: WMINet_Utils.idl

.NET Framework Sürümleri: 4.7.2'den itibaren kullanılabilir

Ayrıca bakınız

• WMI ve Performans Sayaçları (Yönetilmeyen API Başvurusu)