Win32_Share クラスの Delete メソッド

DELETEWMI クラス メソッドは、共有リソースへの接続を切断して、サーバーの共有リソースの一覧から共有名を削除します。

このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。

構文

uint32 Delete();

パラメーター

このメソッドにはパラメーターはありません。

戻り値

次の一覧に記載されている値の 1 つ、またはエラーを示すその他の値を返します。 その他のエラー コードについては、「 WMI エラー定数 」または 「WbemErrorEnum」を参照してください。 一般的な HRESULT 値については、「 システム エラー コード」を参照してください。

成功 (0)

アクセスが拒否されました (2)

不明なエラー (8)

無効な名前 (9)

無効なレベル (10)

無効なパラメーター (21)

共有の重複 (22)

リダイレクトされたパス (23)

不明なデバイスまたはディレクトリ (24)

ネット名が見つかりません (25)

その他 (26 4294967295)

注釈

Delete メソッドはオブジェクト メソッドであり、クラスのインスタンスで使用されます。

メソッドを正常に実行できるのは、Administrators または Account Operators ローカル グループのメンバー、または Communication、Print、または Server オペレーター グループ メンバーシップを持つメンバーだけです。 Print 演算子は、プリンター キューのみを削除できます。 Communication オペレーターは、通信デバイス キューのみを削除できます。

例

次の VBScript コード サンプルでは、指定した共有を削除します。

On Error Resume Next

ComputerName = InputBox("Enter the computer name:", "Delete Share", "localhost")

SName = InputBox("Enter the name of the share:", "Delete Share")



Set Shares = GetObject("winmgmts:\\" & ComputerName & _
 "\root\cimv2").ExecQuery("SELECT * FROM Win32_Share WHERE name = '" & SName & "'")



For Each Share in Shares
 Share.Delete()
Next

次の PowerShell コード サンプルでは、空の共有を削除します。

$Shares = Get-WMIObject Win32_Share | Where {$_.Name -eq ""}

Foreach ($Share in $Shares) {
   $Share.Delete()
}
"{0} blank shares found and removed" -f $shares.count

要件

こちらもご覧ください

オペレーティング システム クラス

Win32_Share