IWbemServices::D eleteClass メソッド (wbemcli.h)

IWbemServices::D eleteClass メソッドは、指定したクラスを現在の名前空間から削除します。 動的インスタンス プロバイダーが クラスに関連付けられている場合、プロバイダーは登録解除され、そのクラスによって呼び出されなくなります。 削除されたクラスから派生したクラスも削除され、関連付けられているプロバイダーも登録解除されます。 クラスが削除されると、指定したクラスとそのサブクラスの未処理の静的インスタンスもすべて削除されます。

動的クラス プロバイダーが クラスを提供する場合、削除の成功は、プロバイダーがクラスの削除をサポートしているかどうかによって異なります。

構文

HRESULT DeleteClass(
  [in]  const BSTR      strClass,
  [in]  long            lFlags,
  [in]  IWbemContext    *pCtx,
  [out] IWbemCallResult **ppCallResult
);

パラメーター

[in] strClass

削除の対象となるクラスの名前。

[in] lFlags

次のいずれかの値を設定できます。

WBEM_FLAG_RETURN_IMMEDIATELY

このフラグにより、これは半同期呼び出しになります。 詳細については、「メソッドの呼び出し」を参照してください。

WBEM_FLAG_OWNER_UPDATE

呼び出し元がプッシュ プロバイダーであることを示します。

[in] pCtx

通常 は NULL です。 それ以外の場合、これは、クラスを削除するプロバイダーが使用できる IWbemContext オブジェクトへのポインターです。 コンテキスト オブジェクトの値は、該当するプロバイダーのドキュメントで指定する必要があります。 このパラメーターの詳細については、「 WMI への呼び出しの作成」を参照してください。

[out] ppCallResult

NULL の場合、このパラメーターは使用されません。 ppCallResult を指定する場合は、エントリで NULL をポイントするように設定する必要があります。 lFlags パラメーターにWBEM_FLAG_RETURN_IMMEDIATELYが含まれている場合、この呼び出しはWBEM_S_NO_ERRORを使用して直ちにを返します。 ppCallResult パラメーターは、新しい IWbemCallResult オブジェクトへのポインターを受け取り、GetCallStatus メソッドを使用して結果を取得するためにポーリングできます。

戻り値

このメソッドは、メソッド呼び出しの状態を示す HRESULT を返します。 次の一覧は、 HRESULT 内に含まれる値の一覧です。

失敗した場合は、COM 関数 GetErrorInfo から使用可能な情報を取得できます。

ネットワークの問題によって Windows Management へのリモート接続が失われると、COM 固有のエラー コードが返される場合もあります。

要件

こちらもご覧ください

IWbemServices

IWbemServices::D eleteClassAsync

エラー コードの取得