创建或更新现有类的实例。 将该实例写入 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,规范化链接,移除外部媒体和导航标记。
