QualifierSet_Put, funkcja

Zapisuje nazwany kwalifikator i wartość. Nowy kwalifikator zastępuje poprzednią wartość tej samej nazwy. Jeśli kwalifikator nie istnieje, zostanie utworzony.

Uwaga / Notatka

Ten interfejs API jest przeznaczony tylko do użytku wewnętrznego. Nie jest ona przeznaczona do użycia z kodu dewelopera.

Składnia

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

Parametry

vFunc
[in] Ten parametr jest nieużywany.

ptr
[in] Wskaźnik do wystąpienia IWbemQualifierSet .

wszName
[in] Nazwa kwalifikatora do zapisu.

pVal
[in] Wskaźnik prawidłowy VARIANT zawierający kwalifikator do zapisu. Ten parametr nie może mieć wartości null.

lFlavor
[in] Jedna z następujących stałych, która definiuje żądane smaki kwalifikatora dla tego kwalifikatora. Wartość domyślna to WBEM_FLAVOR_OVERRIDABLE (0).

Stały	Wartość	Description
WBEM_FLAVOR_OVERRIDABLE	0	Kwalifikator może zostać zastąpiony w klasie pochodnej lub wystąpieniu. Jest to wartość domyślna.
WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE	1	Kwalifikator jest propagowany do wystąpień.
WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS	2	Kwalifikator jest propagowany do klas pochodnych.
WBEM_FLAVOR_NOT_OVERRIDABLE	0x10	Kwalifikator nie może zostać zastąpiony w klasie pochodnej lub wystąpieniu.
WBEM_FLAVOR_AMENDED	0x80	Kwalifikator jest zlokalizowany.

Wartość zwracana

Następujące wartości zwracane przez tę funkcję są zdefiniowane w pliku nagłówka WbemCli.h lub można je zdefiniować jako stałe w kodzie:

Stały	Wartość	Description
WBEM_E_CANNOT_BE_KEY	0x8004101f	Wystąpiła nielegalna próba określenia Key kwalifikatora właściwości, która nie może być kluczem. Klucze są określone w definicji klasy dla obiektu i nie mogą być zmieniane dla poszczególnych wystąpień.
WBEM_E_INVALID_PARAMETER	0x80041008	Parametr jest nieprawidłowy.
WBEM_E_INVALID_QUALIFIER_TYPE	0x80041029	Parametr pVal nie jest typem kwalifikatora prawnego.
WBEM_E_OVERRIDE_NOT_ALLOWED	0x8004101a	Nie można wywołać QualifierSet_Put metody w kwalifikatorze, ponieważ obiekt, który jest właścicielem, nie zezwala na przesłonięcia.
WBEM_S_NO_ERROR	0	Wywołanie funkcji zakończyło się pomyślnie.

Uwagi

Ta funkcja opakowuje wywołanie metody IWbemQualifierSet::P ut .

Requirements

Platformy: Zobacz Wymagania systemowe.

Nagłówek: WMINet_Utils.idl

Wersje programu .NET Framework: Dostępne od wersji 4.7.2

Zobacz także

• Liczniki wydajności i usługi WMI (niezarządzana dokumentacja interfejsu API)