SWbemObject.Put_ 方法

SWbemObject 的 Put\_ 方法将实例或类创建或更新到 Windows Management Instrumentation (WMI)。修改 SWbemObject 中的任何属性或方法后，可使用此方法，并且更改会写入 WMI。

有关此语法的说明，请参阅脚本 API 的文档约定。

语法

objObjectPath = .Put_( _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

iFlags [输入参数，可选]

此参数确定调用是创建还是更新类或实例，以及调用是否立即返回。此参数可以接受以下值。

wbemChangeFlagUpdateCompatible (0 (0x0))

如果没有派生类，并且没有类的实例，则允许更新该类。如果更改仅限于不重要的限定符（例如 Description 限定符），它还允许在所有情况下进行更新。这是此调用的默认行为，用于与早期版本的 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 [in, optional]

通常情况下不定义此参数。否则，这就是 SWbemObjectPath 对象，其元素表示为请求提供服务的提供程序可使用的上下文信息。支持或需要此类信息的提供程序必须记录已识别的值名称、值数据类型、允许的值和语义。

如果调用成功，会返回一个 SWbemObjectPath 对象。此对象包含已成功提交到 WMI 的实例或类的对象路径。

Put_ 方法完成后，Err 对象可能包含以下列表中的错误代码之一。

wbemErrAccessDenied - 2147749891: 当前用户无权更新指定类的实例。
wbemErrAlreadyExists - 2147749913 (0x80041019): 指定了 wbemChangeFlagCreateOnly 标志，但是该实例已经存在。
wbemErrFailed - 2147749889 (0x80041001): 错误。
wbemErrIllegalNull - 2147749898 (0x8004100A): 为可能不是 Nothing 的属性指定了 Nothing 值。用 Key、Indexed 或 Not_Null 限定符标记的属性就是这类属性的一个示例。
wbemErrInvalidObject - 2147749908 (0x80041014): 指定的实例无效。
wbemErrInvalidParameter - 0x80041008: 指定的参数无效。
wbemErrNotFound - 2147749890 (0x80041002): 指定了 wbemChangeFlagUpdateOnly 标志，但实例或类不存在。
wbemErrIncompleteClass - 2147749920 (0x80041020): 尚未完全设置类的必需属性。
wbemErrOutOfMemory - 2147749894 (0x80041006): 内存不足，无法完成此操作。