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
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 |