SWbemQualifierSet.Add 方法

SWbemQualifierSet物件的Add方法會將SWbemQualifier物件新增至SWbemQualifierSet集合。 如果集合中已經有同名的限定詞，則會取代它。

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

語法

objQualifier = .Add( _
  ByVal strName, _
  ByVal varVal, _
  [ ByVal bPropagatesToSubclasses ], _
  [ ByVal bPropagatesToInstances ], _
  [ ByVal bOverridable ], _
  [ ByVal iFlags ] _
)

參數

strName [in]

必要。 新限定詞的名稱。

varVal [in]

必要。 新限定詞的變異值。

bPropagatesToSubclasses [in， optional]

布林值，指出這個新限定詞是否傳播至子類別。 預設值為 TRUE。

bPropagatesToInstances [in， optional]

布林值，指出這個新限定詞是否傳播至實例。 預設值為 TRUE。

bOverridable [in， optional]

布林值，指出傳播時是否可以覆寫此限定詞。 預設值為 TRUE。

iFlags [in， optional]

保留的。 預設值為 0。

傳回值

如果成功，這個方法會傳回代表新限定詞的 SWbemQualifier 物件。 否則會傳回 Null 物件。

錯誤碼

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

wbemErrInvalidParameter - 2147749896 (0x80041008)

iFlags參數無效。

wbemErrFailed - 2147749889 (0x80041001)

未指定的錯誤。

wbemErrCannotBeKey - 2147749919 (0x8004101F)

在不能是 索引鍵 的屬性上指定金鑰限定詞時，發生不合法的嘗試。 索引鍵會在物件的類別定義中指定，並且不能對每個執行個體進行變更。

wbemErrInvalidQualifierType - 2147749929 (0x80041029)

varVal參數不是合法的限定詞類型。

wbemErrOverrideNotAllowed - 2147749914 (0x8004101A)

無法在此限定詞上執行 SWbemQualifierSet.Add 作業，因為擁有物件不允許覆寫。

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
標頭	Wbemdisp.h
類型程式庫	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemQualifierSet
IID	IID_ISWbemQualifierSet

另請參閱

SWbemQualifierSet

SWbemQualifierSet.Remove