Metodo SWbemPropertySet.Add

Articolo
06/13/2023

Il metodo Add dell'oggetto SWbemPropertySet aggiunge un oggetto SWbemProperty all'insieme SWbemPropertySet . Se nella raccolta esiste già una proprietà con lo stesso nome, il relativo contenuto viene sostituito con la nuova definizione.

Nota

Il valore della proprietà aggiunta è NULL (non assegnato) dopo questa operazione. Per impostare o modificare il valore di una proprietà WMI, è necessario impostare la proprietà Value dell'oggetto SWbemProperty restituito.

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

Sintassi

objProperty = .Add( _
  ByVal strName, _
  ByVal iCIMType, _
  [ ByVal bIsArray ], _
  [ ByVal iFlags ] _
)

Parametri

strName [in]: Obbligatorio. Nome della nuova proprietà.
iCIMType [in]: Obbligatorio. Intero che rappresenta il qualificatore CIMType della nuova proprietà. Vedere WbemCimTypeEnum per l'elenco con i qualificatori CIMType e i relativi valori.
bIsArray [in, facoltativo]: Specifica se la proprietà è un tipo di matrice. Il valore predefinito per questo parametro è FALSE.
iFlags [in, facoltativo]: Riservato e deve essere zero se specificato.

Valore restituito

In caso di esito positivo, questo metodo restituisce un oggetto SWbemProperty che rappresenta la nuova proprietà. In caso contrario, viene restituito un oggetto Null .

Codici di errore

Al termine del metodo Add , l'oggetto Err può contenere uno dei codici di errore riportati di seguito.

wbemErrFailed - 2147749889 (0x80041001): Errore non specificato.
wbemErrInvalidParameter - 2147749896 (0x80041008): È stato specificato un parametro non valido.
wbemErrOutOfMemory - 2147749894 (0x80041006): Memoria insufficiente per l'esecuzione di questo metodo.
wbemErrInvalidPropertyType - 2147749930: Il qualificatore CIMType non viene riconosciuto.

Esempio

Per un esempio di codice che usa questo metodo, vedere l'argomento SWbemPropertySet .

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_SWbemPropertySet
IID	IID_ISWbemPropertySet

Vedi anche

SWbemPropertySet
SWbemPropertySet.Remove
SWbemProperty.Value

Share via