IWbemServices：:D eleteInstance 方法 (wbemcli.h)

IWbemServices：:D eleteInstance 方法會刪除目前命名空間中現有類別的實例。

語法

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

參數

[in] strObjectPath

包含要刪除之實例之物件路徑的有效 BSTR 。

[in] lFlags

下列其中一個值有效。

WBEM_FLAG_RETURN_IMMEDIATELY

此旗標會使此為半異步呼叫。 如需詳細資訊，請參閱 呼叫方法。

[in] pCtx

通常為 NULL。 否則，這是 IWbemContext 物件的指標，可供刪除實例的提供者使用。 內容物件中的值必須在有問題的提供者檔中指定。

[out] ppCallResult

如果為 NULL，則不會使用此參數。 如果指定 ppCallResult ，則必須將它設定為在進入時指向 NULL 。 如果 lFlags 參數包含 WBEM_FLAG_RETURN_IMMEDIATELY，此呼叫會立即傳回 WBEM_S_NO_ERROR。 ppCallResult 參數會接收新 IWbemCallResult 物件的指標，然後可以使用 GetCallStatus 方法輪詢以取得結果。

傳回值

這個方法會傳回 HRESULT ，指出方法呼叫的狀態。 下列清單列出 HRESULT 中包含的值。

失敗時，您可以從 COM 函式 GetErrorInfo 取得任何可用資訊。

如果網路問題造成您失去 Windows 管理遠端連線，也可能傳回 COM 特定的錯誤碼。

備註

呼叫 IWbemServices：:D eleteInstance 方法，以刪除目前命名空間中的現有實例。 無法刪除其他命名空間中的實例。 呼叫 DeleteInstance 以刪除屬於階層中類別的實例時，Windows 管理會針對負責階層中非抽象類別的所有提供者呼叫 DeleteInstanceAsync 方法。 也就是說，如果 strObjectPath 參數識別 ClassB 的實例，而 ClassB 衍生自 ClassA、非抽象類別，而且是 ClassC 和 ClassD 的父類別，也會呼叫所有四個類別的提供者。

Windows 管理會使用修改為指向其類別的物件路徑呼叫每個提供者。 例如，如果原始呼叫的 strObjectPath 設定為 “ClassB.k=1”，則對 ClassA 提供者的呼叫會將 strObjectPath 設定為 “ClassA.k=1”。

DeleteInstance 呼叫的成功取決於對最上層非抽象類別提供者的DeleteInstanceAsync呼叫成功。 非抽象類具有抽象類做為其父系。 如果任一這類類別的提供者成功，作業就會成功;如果所有這類類別都失敗，作業就會失敗。

例如，假設 ClassX 是下列階層的基類：

1. ClassA 衍生自 ClassX。
2. ClassB 衍生自 ClassA。
3. ClassC 和 ClassD 衍生自 ClassB。

如果 ClassX、ClassA 和 ClassB 全都是抽象的，而且 DeleteInstance 中的 strObjectPath 參數指向 ClassB 的實例，則 ClassC 的提供者或 ClassD 的提供者都必須成功。

規格需求

另請參閱

描述實例對象路徑

IWbemCallResult

IWbemServices

IWbemServices：:D eleteInstanceAsync

擷取錯誤碼