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 で指定されたクラス名の名前空間。 このパラメーターには、既定の名前空間 (root\cimv2) を示す NULL を 指定できます。

戻り値

操作が成功した場合 はWBEM_S_NO_ERROR を返し、メモリ不足が原因で操作が失敗した場合は WBEM_E_OUT_OF_MEMORY 、その他の HRESULT エラー コードを返します。

解説

フレームワーク プロバイダーは、プロバイダーの名前を GetEmptyInstance に渡し、空のインスタンスを返します。 このメソッドの一般的な使用方法は、埋め込みオブジェクト プロパティを設定することです。 このメソッドは、 CInstance::SetEmbeddedObject と組み合わせて使用されます。

2 番目の関数プロトタイプは推奨されません。 これは、既存のコードをサポートするためにのみ提供されます。

要件

サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	wbemglue.h (FwCommon.h を含む)
Library	FrameDyn.lib
[DLL]	FrameDynOS.dll;FrameDyn.dll