內含新增方法

內含物件的 Add 方法會將 swbempropertyset物件加入至 內含 集合。 如果集合中已經有相同名稱的屬性,則會將其內容取代為新的定義。

注意

在這項作業之後,已加入的屬性值為 Null (未指派) 。 若要設定或變更 WMI 屬性的值,您必須設定所傳回之 swbempropertyset物件的 value屬性。

如需此語法的說明,請參閱 腳本 API 的檔慣例

語法

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

參數

strName [在]

必要。 新屬性的名稱。

iCIMType [在]

必要。 整數,表示新屬性的 CIMType 限定詞。 如需 CIMType 辨識符號及其值的清單,請參閱 WbemCimTypeEnum

bIsArray [在中,選擇性]

指定屬性是否為數組類型。 此參數的預設值為 FALSE

iFlags [在中,選擇性]

如果已指定,則必須為零。

傳回值

如果成功,這個方法會傳回代表新屬性的 swbempropertyset 物件。 否則,會傳回 null 物件。

錯誤碼

完成 Add 方法之後, Err 物件可能會包含下列其中一個錯誤碼。

wbemErrFailed -2147749889 (0x80041001)

未指定的失敗。

wbemErrInvalidParameter -2147749896 (0x80041008)

指定的參數無效。

wbemErrOutOfMemory -2147749894 (0x80041006)

記憶體不足,無法執行此方法。

wbemErrInvalidPropertyType -2147749930

無法辨識 CIMType 限定詞。

範例

如需使用此方法的程式碼範例,請參閱 內含 主題。

規格需求

需求
最低支援的用戶端
Windows Vista
最低支援的伺服器
Windows Server 2008
標頭
>Wbemdisp.tlb。h
類型程式庫
>Wbemdisp.tlb .tlb
DLL
Wbemdisp.dll
CLSID
CLSID _ 內含
IID
IID _ ISWbemPropertySet

另請參閱

內含

內含。移除

Swbempropertyset。值