Metodo IWbemQualifierSet::P ut (wbemcli.h)

Articolo
08/27/2023

Il metodo IWbemQualifierSet::P ut scrive il qualificatore e il valore denominati. Il nuovo qualificatore sovrascrive il valore precedente dello stesso nome. Se il qualificatore non esiste, viene creato.

In alcuni casi non è possibile scrivere il valore di un qualificatore, ad esempio se il qualificatore viene propagato da un altro oggetto. In genere, i qualificatori propagati sono di sola lettura, ma possono essere sottoposti a override. Per altre informazioni, vedere Tipi di qualificatore.

Quando si usa il qualificatore chiave , non è necessario specificare alcuna regola di propagazione o tipi.

L'utente non può creare qualificatori con nomi che iniziano o terminano con un carattere di sottolineatura (_). Questa opzione è riservata alle classi di sistema e alle proprietà.

Sintassi

HRESULT Put(
  [in] LPCWSTR wszName,
  [in] VARIANT *pVal,
  [in] long    lFlavor
);

Parametri

[in] wszName

Nome del qualificatore in fase di scrittura. Il puntatore viene considerato di sola lettura.

[in] pVal

Non può essere NULL. Deve puntare a un valore VARIANT valido contenente il valore del qualificatore da scrivere. Il puntatore viene considerato di sola lettura. È responsabilità del chiamante chiamare VariantClear su questo puntatore dopo che il valore non è obbligatorio.

Sono supportate solo varianti e matrici di tipo VT_I4, VT_R8, VT_BSTRVT_BOOL .

[in] lFlavor

Tipi di qualificatore desiderati per questo qualificatore. Nell'elenco seguente sono elencate le costanti appropriate per lFlavor. Il valore predefinito è zero (0).

WBEM_FLAVOR_OVERRIDABLE (0 (0x0))

Il valore del qualificatore può essere sottoposto a override in una classe derivata o in un'istanza di . Questo è il valore predefinito. L'uso di questa costante equivale all'uso del flag EnableOverride .

WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE (1 (0x1))

Il qualificatore viene propagato alle istanze. L'uso di questa costante equivale all'uso del flag ToInstance .

WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS (2 (0x2))

Il qualificatore viene propagato alle classi derivate. L'uso di questa costante equivale all'uso del flag ToSubClass .

WBEM_FLAVOR_NOT_OVERRIDABLE (16 (0x10))

Il valore del qualificatore non può essere sottoposto a override in una classe derivata o in un'istanza di . L'uso di questa costante equivale all'uso del flag DisableOverride .

WBEM_FLAVOR_AMENDED (128 (0x80))

Il qualificatore viene localizzato. L'uso di questa costante equivale all'uso del flag Modificato .

Valore restituito

Questo metodo restituisce un valore HRESULT che indica lo stato della chiamata al metodo. L'elenco seguente elenca il valore contenuto in hrESULT.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	wbemcli.h (include Wbemidl.h)
Libreria	Wbemuuid.lib
DLL	Fastprox.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll

Vedi anche

Tipi di qualificatore

Condividi tramite