Metodo SWbemPropertySet.Add
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 |
|
| Libreria dei tipi |
|
| DLL |
|
| CLSID |
CLSID_SWbemPropertySet |
| IID |
IID_ISWbemPropertySet |