Share via


Metodo SWbemQualifierSet.Add

Il metodo Add dell'oggetto SWbemQualifierSet aggiunge un oggetto SWbemQualifier all'insieme SWbemQualifierSet . Se nella raccolta esiste già un qualificatore con lo stesso nome, viene sostituito.

Per una spiegazione di questa sintassi, vedere Document Conventions per l'API di scripting.

Sintassi

objQualifier = .Add( _
  ByVal strName, _
  ByVal varVal, _
  [ ByVal bPropagatesToSubclasses ], _
  [ ByVal bPropagatesToInstances ], _
  [ ByVal bOverridable ], _
  [ ByVal iFlags ] _
)

Parametri

strName [in]

Obbligatorio. Nome del nuovo qualificatore.

varVal [in]

Obbligatorio. Valore variant del nuovo qualificatore.

bPropagatesToSubclasses [in, facoltativo]

Valore booleano che indica se questo nuovo qualificatore viene propagato alle sottoclassi. Il valore predefinito è TRUE.

bPropagatesToInstances [in, facoltativo]

Valore booleano che indica se questo nuovo qualificatore viene propagato alle istanze. Il valore predefinito è TRUE.

bOverridable [in, facoltativo]

Valore booleano che indica se questo qualificatore può essere sottoposto a override durante la propagazione. Il valore predefinito è TRUE.

iFlags [in, facoltativo]

Riservato. Il valore predefinito è 0.

Valore restituito

In caso di esito positivo, questo metodo restituisce un oggetto SWbemQualifier che rappresenta il nuovo qualificatore. In caso contrario, viene restituito un oggetto Null .

Codici di errore

Dopo il completamento del metodo Add , l'oggetto Err può contenere uno dei codici di errore nell'elenco seguente.

wbemErrInvalidParameter - 2147749896 (0x80041008)

Il parametro iFlags non è valido.

wbemErrFailed - 2147749889 (0x80041001)

Errore non specificato.

wbemErrCannotBeKey - 2147749919 (0x8004101F)

Si è verificato un tentativo non valido di specificare un 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.

wbemErrInvalidQualifierType - 2147749929 (0x80041029)

Il parametro varVal non è di un tipo qualificatore legale.

wbemErrOverrideNotAllowed - 2147749914 (0x8004101A)

Non è possibile eseguire l'operazione SWbemQualifierSet.Add su questo qualificatore perché l'oggetto proprietario non consente gli override.

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista
Server minimo supportato
Windows Server 2008
Intestazione
Wbemdisp.h
Libreria dei tipi
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID_SWbemQualifierSet
IID
IID_ISWbemQualifierSet

Vedi anche

SWbemQualifierSet

SWbemQualifierSet.Remove