共用方式為

SWbemObject.Delete_ 方法

  • 發行項

SWbemObject物件的Delete_方法會刪除目前類別或目前的實例。 如果動態提供者提供 類別或實例，除非提供者支援類別或實例刪除，否則有時無法刪除此物件。 如需此語法的說明，請參閱 腳本 API 的檔慣例。

語法

SWbemObject.Delete_( _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

參數

iFlags [in， optional]

如果指定，則保留且必須是 0 (零) 。

objwbemNamedValueSet [in， optional]

此參數通常未定義。 否則，這是 SWbemNamedValueSet 物件，其元素代表服務要求的提供者可以使用的內容資訊。 支援或需要這類資訊的提供者必須記載已辨識的值名稱、值的資料類型、允許的值和語意。

傳回值

這個方法不會傳回值。

錯誤碼

完成 Delete_ 方法之後， Err 物件可能會包含下列清單中的其中一個錯誤碼。

wbemErrAccessDenied - 2147749891 (0x80041003)

目前的內容沒有足夠的安全性許可權可刪除物件。

wbemErrFailed - 2147749889 (0x80041001)

未指定的錯誤。

wbemErrInvalidClass - 2147749904 (0x80041010)

指定的類別不存在。

wbemErrInvalidOperation - 2147749910 (0x80041016)

無法刪除物件。

wbemErrNotFound - 2147749890 (0x80041002)

物件不存在。

wbemErrOutOfMemory - 2147749894 (0x80041006)

記憶體不足，無法完成作業。

備註

如果建立SWbemObject的新實例，但索引鍵屬性沒有提供任何值，則Delete_方法會失敗。 Windows Management Instrumentation (WMI) 會自動產生全域唯一識別碼 (GUID) 值，但 SWbemObject.Delete_不接受 GUID 值。 在此情況下， SWbemServices.Delete會使用物件路徑運作。 請注意，在物件認可至 WMI 之後，SWbemObject.Put_方法會傳回SWbemObjectPath物件。

範例

下列範例會建立新的類別;加入索引鍵屬性;將新類別寫入存放庫;和 會顯示新類別物件的路徑。 然後腳本會繁衍新類別的實例;寫入它;和 會顯示路徑。 請注意，腳本只要刪除 類別，即可從存放庫刪除 類別及其實例。

On Error Resume Next
wbemCimtypeString = 8             ' String datatype
Set objSWbemService = GetObject("Winmgmts:root\default")
Set objClass = objSWbemService.Get()
objClass.Path_.Class = "NewClass"

' Add a property
' String property
objClass.Properties_.add "PropertyName", wbemCimtypeString 
' Make the property a key property 
objClass.Properties_("PropertyName").Qualifiers_.Add "key", TRUE

' Write the new class to the root\default namespace in the repository
Set objClassPath = objClass.Put_
wscript.echo objClassPath.Path

'Create an instance of the new class using SWbemObject.SpawnInstance
Set objNewInst = GetObject( _
    "Winmgmts:root\default:NewClass").SpawnInstance_

objNewInst.PropertyName = "My Instance"

' Write the instance into the repository
Set objInstancePath = objNewInst.Put_
wscript.echo objInstancePath.Path

' Remove the new class and instance from the repository
objClass.Delete_()
If Err <> 0 Then
    WScript.Echo Err.Number & "    " & Err.Description 
Else
    WScript.Echo "Delete succeeded"
End If

' Release SwbemServices object
Set objSWbemService = Nothing

規格需求

需求 值
最低支援的用戶端
 Windows Vista
最低支援的伺服器
 Windows Server 2008
標頭
Wbemdisp.h
類型程式庫
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
 CLSID_SWbemObject
IID
 IID_ISWbemObject