共用方式為


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
標頭
Wbemdisp.h
類型程式庫
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID_SWbemPropertySet
IID
IID_ISWbemPropertySet

另請參閱

SWbemPropertySet

SWbemPropertySet.Remove

SWbemProperty.Value