SWbemPropertySet.Add 方法
SWbemPropertySet物件的Add方法會將SWbemProperty物件新增至SWbemPropertySet集合。 如果集合中已經存在具有相同名稱的屬性,則會將其內容取代為新的定義。
注意
加入的屬性值為 Null (在此作業之後未指派的) 。 若要設定或變更 WMI 屬性的值,您必須設定傳回之 SWbemProperty物件的Value屬性。
如需此語法的說明,請參閱 腳本 API 的檔慣例。
語法
objProperty = .Add( _
ByVal strName, _
ByVal iCIMType, _
[ ByVal bIsArray ], _
[ ByVal iFlags ] _
)
參數
-
strName [in]
-
必要。 新屬性的名稱。
-
iCIMType [in]
-
必要。 整數,表示新屬性的 CIMType 限定詞。 如需CIMType限定詞及其值的清單,請參閱WbemCimTypeEnum。
-
bIsArray [in, optional]
-
指定屬性是否為數組類型。 此參數的預設值為 FALSE。
-
iFlags [in, optional]
-
保留 ,如果指定,則必須為零。
傳回值
如果成功,這個方法會傳回代表新屬性的 SWbemProperty 物件。 否則會傳回 Null 物件。
錯誤碼
完成 Add方法之後,Err物件可能會包含下列其中一個錯誤碼。
-
wbemErrFailed - 2147749889 (0x80041001)
-
未指定的失敗。
-
wbemErrInvalidParameter - 2147749896 (0x80041008)
-
指定了不正確參數。
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
這個方法的記憶體不足,無法執行。
-
wbemErrInvalidPropertyType - 2147749930
-
無法辨識 CIMType 限定詞。
範例
如需使用此方法的程式碼範例,請參閱 SWbemPropertySet 主題。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |
標頭 |
|
類型程式庫 |
|
DLL |
|
CLSID |
CLSID_SWbemPropertySet |
IID |
IID_ISWbemPropertySet |