共用方式為

Provider：:P utInstance (IWbemClassObject*，long，MethodContext*) method (provider.h)

  • 發行項

[提供者類別是 WMI 提供者 架構的一部分，現在被視為最終狀態，而且不會針對影響這些連結庫的非安全性相關問題使用進一步的開發、增強功能或更新。 MI API 應該用於所有新的開發。]

PutInstance 方法會更新 實例。

語法

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

參數

pInst

TBD

lFlags

旗標的位掩碼，其中包含更新作業的相關信息。 這是 IWbemServices：:P utInstance 方法中用戶端所指定的值。

下列旗標由 (處理，並依 WMI 篩選出) ：

  • WBEM_FLAG_RETURN_IMMEDIATELY
有效的 lFlags 值為：
  • WBEM_FLAG_CREATE_ONLY
  • WBEM_FLAG_CREATE_OR_UPDATE
  • WBEM_FLAG_UPDATE_ONLY

pContext

TBD

傳回值

此方法的默認架構提供者實作會將 WBEM_E_PROVIDER_NOT_CAPABLE 傳回給呼叫方法。 IWbemServices：:P utInstance 方法會列出最常見的傳回值，不過您可以選擇傳回任何 COM 傳回碼。

備註

當用戶端針對類別呼叫 IWbemServices：:P utInstance 時，WMI 會叫用 PutInstance。 如果您的架構提供者更新實例，您必須實作 PutInstance 。 下列清單描述 PutInstance 的常見實作：

  1. 使用 CInstance 的 Get 方法檢查用戶端傳入的索引鍵屬性，例如 CInstance：：GetCHString。

    您的實作應該判斷您的提供者是否支援用戶端所要求的變更。

  2. 視需要建立或更新適當的Managed物件。
  3. 傳回適當的傳回值。

    如果您的提供者不支援用戶端所要求的變更，您應該傳回適當的錯誤碼。 如需有效錯誤碼的完整清單，請參閱 IWbemServices：:P utInstance。

規格需求

需求 值
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 provider.h (include FwCommon.h)
程式庫 FrameDyn.lib
Dll FrameDynOS.dll;FrameDyn.dll