大网数据广告活动
.NET 与 C# 开发

PutInstanceWmi 函数 (非托管 API 参考)

· 52CE 我爱测

PutInstanceWmi 函数创建或更新现有类的实例。

创建或更新现有类的实例。 将该实例写入 WMI 存储库。

Note: 此 API 仅供内部使用。 不应从开发人员代码中使用。

语法

HRESULT PutInstanceWmi (
   [in] IWbemClassObject*    pInst,
   [in] long                 lFlags,
   [in] IWbemContext*        pCtx,
   [out] IWbemCallResult**   ppCallResult
);

参数

pInst
[in]指向要写入的实例的指针。

lFlags
[in]影响此函数的行为的标志的组合。 以下值中定义WbemCli.h标头文件,也可以在定义它们为常量在代码中:

返回的常量 值 描述
WBEM_FLAG_USE_AMENDED_QUALIFIERS 0x20000 如果设置,WMI 不存储任何与限定符Amended风格。 如果未设置,将假定未本地化此对象,并与此实例中存储所有的限定符。
WBEM_FLAG_CREATE_OR_UPDATE 0 如果不存在,或者覆盖它,如果它已存在,请创建该实例。
WBEM_FLAG_UPDATE_ONLY 1 更新的实例。 若要成功的调用必须存在的实例。
WBEM_FLAG_CREATE_ONLY 2 创建该实例。 如果该实例已存在,则调用将失败。
WBEM_FLAG_RETURN_IMMEDIATELY 0x10 该标志会导致半同步调用。

pCtx
[in]通常情况下,此值是null。 否则,它是一个指向IWbemContext可由提供程序提供请求的类的实例。

ppCallResult
[out]如果null,此参数未被使用。 如果lFlags包含WBEM_FLAG_RETURN_IMMEDIATELY,该函数将立即返回与WBEM_S_NO_ERROR。 ppCallResult参数接收指向新IWbemCallResult对象。

返回值

此函数返回以下值中定义WbemCli.h标头文件,也可以在定义它们为常量在代码中:

返回的常量 值 描述
WBEM_E_ACCESS_DENIED 0x80041003 用户没有权限来更新指定类的实例。
WBEM_E_FAILED 0x80041001 发生未知的错误。
WBEM_E_INVALID_CLASS 0x80041010 支持此实例的类不是有效的。
WBEM_E_ILLEGAL_NULL 0x80041028 null不能为属性指定了null,例如标记索引或Not_Null限定符。
WBEM_E_INVALID_OBJECT 0x8004100f 指定的实例不是有效的。 (例如,调用PutInstanceWmi类将返回此值。)
WBEM_E_INVALID_PARAMETER 0x80041008 参数不是有效的。
WBEM_E_ALREADY_EXISTS 0x80041019 WBEM_FLAG_CREATE_ONLY指定标志,但该实例已存在。
WBEM_E_NOT_FOUND 0x80041002 WBEM_FLAG_UPDATE_ONLY 中指定了lFlags,但该实例不存在。
WBEM_E_OUT_OF_MEMORY 0x80041006 没有足够的内存是可用于完成该操作。
WBEM_E_SHUTTING_DOWN 0x80041033 WMI 是可能已停止并重新启动。 调用ConnectServerWmi试。
WBEM_E_TRANSPORT_FAILURE 0x80041015 之间的当前进程和 WMI 的远程过程调用 (RPC) 链接已失败。
WBEM_S_NO_ERROR 0 函数调用成功。

备注

此函数包装对的调用IWbemServices::PutInstance方法。

PutInstanceWmi函数支持创建实例和更新现有的类的实例。 具体取决于如何pCtx设置参数,则更新以下某些或所有实例的属性。

当实例指向的pInst属于子类,Windows 管理调用负责子类派生的类的所有提供程序。 所有这些提供程序必须成功执行原始PutInstanceWmi请求才能成功。 在层次结构中支持的最顶层类的提供程序首先调用。 调用顺序将继续执行的最顶层类的子类,并继续从顶部到底部 Windows 管理直到拥有由指向该实例的类的提供程序pInst。 Windows 管理不会调用任何实例的子类别的提供程序。

当应用程序必须更新属于类层次结构的实例时pInst参数必须指向包含要修改的属性的实例。 也就是说,请考虑属于的目标实例ClassB。 ClassB实例派生ClassA,并ClassA定义的属性PropA。 如果应用程序想要更改的值PropA中ClassB实例,它必须设置pInst到该实例而不是实例ClassA.

调用PutInstanceWmi不允许抽象类的实例上。

如果函数调用失败,则可以通过调用获取其他错误信息GetErrorInfo函数。

要求

平台: 请参阅系统需求。

标头: WMINet_Utils.idl

**.NET Framework 版本:**自 4.7.2 之后可用

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 rpetrusha)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 11/06/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。