SWbemServicesEx.Put 方法

SWbemServicesEx物件的Put方法會將物件儲存至系結至物件的命名空間，並傳回SWbemObjectPath物件，其中包含寫入資料之物件的路徑。

這個方法會在半同步模式中呼叫。如需詳細資訊，請參閱呼叫方法。

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

語法

objObjectPath = .Put( _
  ByVal objWbemObject, _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ] _
)

objWbemObject

必要。要放入命名空間中的新物件。這可以是新建立的物件或修改的物件。

iFlags [選擇性]

此參數會判斷呼叫是否建立或更新物件，以及呼叫是否立即傳回。此參數可以接受下列值。

wbemChangeFlagUpdateCompatible (0 (0x0) )

如果沒有衍生類別，而且沒有該類別的實例，則允許更新類別。如果變更只是非重要限定詞 (，則它也會在所有情況下都允許更新，例如描述限定詞) 。這是此呼叫的預設行為，用於與舊版 WMI 的相容性。如果類別有執行個體，更新就會失敗。

wbemChangeFlagUpdateSafeMode (32 (0x20) )

即使有子類別，當變更不會與子類別發生任何衝突時，仍允許更新類別。將新屬性新增至先前未在任何子類別中提及的基類時，您可以使用這個旗標。如果類別有執行個體，更新就會失敗。

wbemChangeFlagUpdateForceMode (64 (0x40) )

當衝突的子類別存在時，此旗標會強制更新類別。例如，如果類別限定詞是在子類別中定義，而且基類會嘗試新增與現有限定詞衝突的相同限定詞，則此旗標會強制更新。在強制模式中，刪除子類別中的衝突限定詞，即可解決此衝突。如果類別有執行個體，更新就會失敗。

使用強制模式來更新靜態類別會導致刪除該類別的所有實例。提供者類別上的強制更新不會刪除類別的實例。

wbemChangeFlagCreateOrUpdate (0 (0x0) )

如果類別或實例不存在，則會導致建立類別或實例，如果已經存在，則予以覆寫。

wbemChangeFlagCreateOnly (2 (0x2) )

僅用於建立。如果類別或實例已經存在，呼叫就會失敗。

wbemChangeFlagUpdateOnly (1 (0x1) )

導致此呼叫只執行更新。類別或實例必須存在，才能成功呼叫。

wbemFlagReturnImmediately (16 (0x10) )

導致呼叫立即傳回。

wbemFlagReturnWhenComplete (0 (0x0) )

造成此呼叫封鎖，直到作業完成為止。這個旗標會以同步模式呼叫方法。

wbemFlagUseAmendedQualifiers (131072 (0x20000) )

導致 WMI 寫入類別增修條款資料以及基類定義。如需詳細資訊，請參閱當地語系化 WMI 類別資訊。

objWbemNamedValueSet [選擇性]

一般而言，這是未定義的。否則，這是 SWbemNamedValueSet 物件，其元素代表服務要求的提供者可以使用的內容資訊。支援或需要這類資訊的提供者必須記載已辨識的值名稱、值的資料類型、允許的值和語意。

如果呼叫成功，則會傳回 SWbemObjectPath 物件。此物件包含已成功認可至 WMI 之實例或類別的物件路徑。

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

wbemErrAccessDenied - 2147749891 (0x80041003): 目前使用者沒有作業的許可權。
wbemErrAlreadyExists - 2147749913 (0x80041019): 已指定 wbemChangeFlagCreateOnly 旗標，但實例已經存在。
wbemErrFailed - 2147749889 (0x80041001): 未指定的錯誤。
wbemErrIllegalNull - 2147749898 (0x8004100A): 為不可為Null的屬性指定Null值。這類屬性的範例是索引鍵、索引或 Not_Null 限定詞所標記的屬性。
wbemErrInvalidObject - 2147749908 (0x80041014): 指定的物件無效。
wbemErrInvalidParameter - 2147749896 (0x80041008): 指定的參數無效。
wbemErrNotFound - 2147749890 (0x80041002): 已指定 wbemChangeFlagUpdateOnly 旗標，但實例或類別不存在。
wbemErrIncompleteClass - 2147749920 (0x80041020): 尚未設定類別的必要屬性。
wbemErrOutOfMemory - 2147749894 (0x80041006): 記憶體不足，無法完成作業。