Put 方法

描述

SWbemServicesEx对象的放方法将对象保存到绑定到对象的命名空间，并返回一个包含写入数据的对象的路径的SWbemObjectPath对象。

这种方法在半同步模式下被调用。有关详细信息，请参阅调用方法.

PowerBASIC 语法

METHOD Put ( _

BYVAL objWbemObject AS ISWbemServicesEx, _

OPTIONAL BYVAL iFlags AS LONG, _

OPTIONAL BYVAL objWbemNamedValueSet AS IDispatch _

) AS ISWbemObjectPath

参数

objWbemObject

需要。要放在命名空间中的新对象。这可以是新创建的对象或修改对象。

iFlags

LONG.此参数确定调用是创建还是更新对象，并且调用是否立即返回。此参数可以接受以下值。

值	含义
wbemChangeFlagUpdateCompatible 0 &H0	如果没有派生类，并且没有该类的实例，则允许更新类。它还允许在所有情况下更新只有不重要的限定符（例如描述限定符））。这是此调用的默认行为，用于与以前版本的WMI兼容。如果类有实例，则更新失败。
wbemChangeFlagUpdateSafeMode 32 &H20	允许更新类，即使有子类，当更改不会导致与子类的任何冲突。将新属性添加到以前没有在任何子类中提到的基类时，可以使用此标志。如果类有实例，则更新失败。
wbemChangeFlagUpdateForceMode 64 &H40	当存在冲突的子类时，此标志强制更新类。例如，如果在子类中定义了类限定词，则此标志强制更新，并且基类尝试添加与现有类限定符冲突的相同限定符。在强制模式下，通过删除子类中的冲突限定符来解决此冲突。如果类有实例，则更新失败。使用force模式来更新静态类会导致删除该类的所有实例。提供程序类上的强制更新不会删除该类的实例。
wbemChangeFlagCreateOrUpdate 0 &H0	导致类或实例被创建，如果它不存在，或覆盖，如果它已经存在。
wbemChangeFlagCreateOnly 2 &H2	仅用于创作。如果类或实例已经存在，则调用失败。
wbemChangeFlagUpdateOnly 1 &H1	使此呼叫仅执行更新。类或实例必须存在才能使呼叫成功。
wbemFlagReturnImmediately 16 &H10	使呼叫立即返回。
wbemFlagReturnWhenComplete 0 &H0	导致此呼叫阻止，直到操作完成。该标志在同步模式下调用该方法。
wbemFlagUseAmendedQualifiers 131072 &H20000	导致WMI编写类修改数据以及基类定义。有关详细信息，请参阅本地化WMI类信息.

objWbemNamedvalueSet

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

返回值

如果呼叫成功，则返回SWbemObjectPath对象。此对象包含已成功提交给WMI的实例或类的对象路径。

OBJRESULT

错误（名称/十进制/十六进制）	含义
wbemErrAccessDenied -2147217405 &H80041003	当前用户没有操作权限。
wbemErrAlreadyExists -2147217383 &H80041019	指定了wbemChangeFlagCreateOnly标志，但实例已存在。
wbemErrFailed -2147217407 &H80041001	未指定错误
wbemErrIllegalNull -2147217368 &H8004100A	为不能为NULL的属性指定了NULL值。这种属性的一个例子是由键，索引或Not_Null限定词标示的属性。
wbemErrInvalidObject -2147217393 &H80041014	指定的对象无效。
wbemErrInvalidParameter -2147217400 &H80041008	指定了无效参数。
wbemErrNotFound -2147217406 &H80041002	指定了wbemChangeFlagUpdateOnly标志，但实例或类不存在。
wbemErrIncompleteClass -2147217376 &H80041020	类的必需属性尚未设置。
wbemErrOutOfMemory -2147217402 &H80041006	没有足够的内存来完成操作。

要求

客户	需要Windows Vista或Windows XP。
服务器	需要Windows Server 2008或Windows Server 2003。
类型库	使用Wbemdisp.tlb。
头	Wbemdisp.inc。
DLL	需要Wbemdisp.dll。