共用方式為

CWbemProviderGlue：：GetEmptyInstance (MethodCoNtext*，LPCWSTR，CInstance**，LPCWSTR) 方法 (wbemglue.h)

  • 發行項

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

GetEmptyInstance方法會擷取指定類別的單一未填入實例。

語法

HRESULT GetEmptyInstance(
  MethodContext *pMethodContext,
  LPCWSTR       pszClassName,
  CInstance     **ppInstance,
  LPCWSTR       pszNamespace
);

參數

pMethodContext

目前內容的指標。

pszClassName

要傳回其實例的類別名稱。

ppInstance

用來儲存新實例之 CInstance 類別實例的指標。 呼叫 GetEmptyInstance的架構提供者必須釋放此指標。

pszNamespace

pszClassName所指定的類別名稱命名空間。 這個參數可以是 Null ，表示預設命名空間，也就是 root\cimv2。

傳回值

如果作業成功，則傳回 WBEM_S_NO_ERROR ， WBEM_E_OUT_OF_MEMORY 作業因記憶體不足或任何其他 HRESULT 錯誤碼而失敗。

備註

架構提供者會將提供者的名稱傳遞至 GetEmptyInstance，這會傳回空的實例。 這個方法的常見用法是填入內嵌的物件屬性。 這個方法會與 CInstance：：SetEmbeddedObject搭配使用。

不建議使用第二個函式原型。 它只會提供以支援現有的程式碼。

規格需求

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