Provider：:P utInstance (IWbemClassObject，long，MethodContext) 方法 (provider.h)

[Provider 类是 WMI 提供程序框架的一部分，现在视为处于最终状态，对于影响这些库的非安全性相关问题，将不会提供进一步的开发、增强或更新。所有新开发均应使用 MI API。]

PutInstance 方法更新实例。

语法

HRESULT PutInstance(
  IWbemClassObject *pInst,
  long             lFlags,
  MethodContext    *pContext
);

pInst

TBD

lFlags

包含更新操作相关信息的标志的位掩码。这是客户端在 IWbemServices：:P utInstance 方法中指定的值。

以下标志由 (处理，并由 WMI 筛选出) ：

有效的 lFlags 值为：

pContext

TBD

此方法的默认框架提供程序实现将 WBEM_E_PROVIDER_NOT_CAPABLE 返回到调用方法。尽管可以选择返回任何 COM 返回代码，但 IWbemServices：:P utInstance 方法列出了最常见的返回值。

当客户端针对类调用 IWbemServices：:P utInstance 时，WMI 会调用 PutInstance。如果框架提供程序更新实例，则必须实现 PutInstance 。以下列表介绍了 PutInstance 的常见实现：

使用 CInstance 的 Get 方法（例如 CInstance：：GetCHString）检查客户端传入的键属性。
实现应确定提供程序是否支持客户端请求的更改。
根据需要创建或更新相应的托管对象。
返回相应的返回值。
如果提供程序不支持客户端请求的更改，则应返回相应的错误代码。有关有效错误代码的完整列表，请参阅 IWbemServices：:P utInstance。