Metodo IWbemQualifierSet::P ut (wbemcli.h)

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

Vedi anche

Tipi di qualificatore