Funzione QualifierSet_Put

Articolo
04/08/2023

Scrive il qualificatore e il valore denominati. Il nuovo qualificatore sovrascrive il valore precedente dello stesso nome. Se il qualificatore non esiste, viene creato.

Nota

Questa API è solo per uso interno. Non è destinata all'uso dal codice dello sviluppatore.

Sintassi

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

Parametri

vFunc
[in] Questo parametro non è usato.

ptr
[in] Puntatore a un'istanza di IWbemQualifierSet .

wszName
[in] Nome del qualificatore da scrivere.

pVal
[in] Puntatore a un oggetto valido VARIANT contenente il qualificatore da scrivere. Questo parametro non può essere null.

lFlavor
[in] Una delle costanti seguenti che definisce i tipi di qualificatore desiderati per questo qualificatore. Il valore predefinito è WBEM_FLAVOR_OVERRIDABLE (0).

Costante	Valore	Descrizione
`WBEM_FLAVOR_OVERRIDABLE`	0	Il qualificatore può essere sottoposto a override in una classe o in un'istanza derivata. Rappresenta il valore predefinito.
`WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE`	1	Il qualificatore viene propagato alle istanze.
`WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS`	2	Il qualificatore viene propagato alle classi derivate.
`WBEM_FLAVOR_NOT_OVERRIDABLE`	0x10	Il qualificatore non può essere sottoposto a override in una classe o in un'istanza derivata.
`WBEM_FLAVOR_AMENDED`	0x80	Il qualificatore viene localizzato.

Valore restituito

I valori seguenti restituiti da questa funzione sono definiti nel file di intestazione WbemCli.h oppure è possibile definirli come costanti nel codice:

Costante	Valore	Descrizione
`WBEM_E_CANNOT_BE_KEY`	0x8004101f	Si è verificato un tentativo non valido di specificare il qualificatore di chiave in una proprietà che non può essere una chiave. Le chiavi sono specificate nella definizione della classe per un oggetto e non possono essere alterate per singole istanze.
`WBEM_E_INVALID_PARAMETER`	0x80041008	Un parametro non è valido.
`WBEM_E_INVALID_QUALIFIER_TYPE`	0x80041029	Il `pVal` parametro non è di un tipo qualificatore legale.
`WBEM_E_OVERRIDE_NOT_ALLOWED`	0x8004101a	Non è possibile chiamare il `QualifierSet_Put` metodo sul qualificatore perché l'oggetto proprietario non consente le sostituzioni.
`WBEM_S_NO_ERROR`	0	La chiamata di funzione ha avuto esito positivo.

Commenti

Questa funzione esegue il wrapping di una chiamata al metodo IWbemQualifierSet::P ut .

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: WMINet_Utils.idl

Versioni di .NET Framework: Disponibile dalla versione 4.7.2

Vedi anche

WMI e contatori delle prestazioni (riferimenti alle API non gestite)

Condividi tramite