SWbemObject.Put_ 方法

SWbemObject的 Put_ 方法创建或更新实例或类对象,以Windows Management Instrumentation (WMI) 。 修改 SWbemObject 中的任何属性或方法后,可以使用此方法,并将所做的更改写入 WMI。

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

语法

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

parameters

iFlags [in, 可选]

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

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 [in, 可选]

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

返回值

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

错误代码

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

wbemErrAccessDenied - 2147749891

当前用户无权更新指定类的实例。

wbemErrAlreadyExists - 2147749913 (0x80041019)

已指定 wbemChangeFlagCreateOnly 标志,但实例已存在。

wbemErrFailed - 2147749889 (0x80041001)

错误。

wbemErrIllegalNull - 2147749898 (0x8004100A)

为可能不是 Nothing 的属性指定了 Nothing 值。 此类属性的一个示例是由 键、索引Not_Null 限定符标记的。

wbemErrInvalidObject - 2147749908 (0x80041014)

指定的实例无效。

wbemErrInvalidParameter - 0x80041008

指定的参数无效。

wbemErrNotFound - 2147749890 (0x80041002)

已指定 wbemChangeFlagUpdateOnly 标志,但实例或类不存在。

wbemErrIncompleteClass - 2147749920 (0x80041020)

尚未设置类的必需属性。

wbemErrOutOfMemory - 2147749894 (0x80041006)

没有足够的内存来完成操作。

要求

要求
最低受支持的客户端
Windows Vista
最低受支持的服务器
Windows Server 2008
标头
Wbemdisp.h
类型库
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID_SWbemObject
IID
IID_ISWbemObject

另请参阅

SWbemObject

SWbemObjectPath.Class

SWbemProperty

SWbemQualifier