Share via


ShareDirectoryClient.ForceCloseAllHandles メソッド

定義

この操作は ForceCloseAllHandles(Nullable<Boolean>, CancellationToken) 、サービスのディレクトリまたはファイルで開かれているすべてのハンドルを閉じます。 必要に応じて、リソースがディレクトリである場合にサブリソースのハンドルを再帰的に閉じることをサポートします。

この API は、ディレクトリの名前変更など、操作をブロックするハンドルを強制的に閉じる目的で、一緒 GetHandles(Nullable<Boolean>, CancellationToken) に使用することを目的としています。 これらのハンドルは、SMB クライアントによってリークまたは追跡されなくなった可能性があります。 API は、ファイルの読み取りまたは書き込みの試行の失敗によるユーザーに表示されるエラーを含め、閉じているハンドルにクライアント側の影響を与えます。 この API は、SMB クローズの代替または代替として使用することを目的としていません。

詳細については、「 ハンドルを強制的に閉じます

public virtual Azure.Storage.Files.Shares.Models.CloseHandlesResult ForceCloseAllHandles (bool? recursive = default, System.Threading.CancellationToken cancellationToken = default);
abstract member ForceCloseAllHandles : Nullable<bool> * System.Threading.CancellationToken -> Azure.Storage.Files.Shares.Models.CloseHandlesResult
override this.ForceCloseAllHandles : Nullable<bool> * System.Threading.CancellationToken -> Azure.Storage.Files.Shares.Models.CloseHandlesResult
Public Overridable Function ForceCloseAllHandles (Optional recursive As Nullable(Of Boolean) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As CloseHandlesResult

パラメーター

recursive
Nullable<Boolean>

省略可能。 指定したディレクトリのファイルとサブディレクトリにも操作を適用するかどうかを指定するブール値。

cancellationToken
CancellationToken

操作を取り消す必要がある通知を伝達する場合は省略可能 CancellationToken です。

戻り値

CloseHandlesResult操作の状態を説明する ForceCloseAllHandles(Nullable<Boolean>, CancellationToken)

注釈

RequestFailedExceptionエラーが発生すると、 がスローされます。

適用対象