共用方式為

Provider：:P utInstance (constCInstance&，long) 方法 (provider.h)

  • 發行項

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

PutInstance 方法會更新 實例。

語法

HRESULT PutInstance(
  [ref] const CInstance & newInstance,
        long              lFlags
);

參數

[ref] newInstance

已更新的實例。

lFlags

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

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

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

傳回值

這個方法的默認架構提供者實作會將 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