ShareDirectoryClient.ForceCloseAllHandlesAsync メソッド

定義

名前空間:

Azure.Storage.Files.Shares

アセンブリ:

Azure.Storage.Files.Shares.dll

パッケージ:

Azure.Storage.Files.Shares v12.18.0

ソース:

ShareDirectoryClient.cs

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

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

F 詳細については、次を参照してください。 ハンドルを強制的に閉じます。

public virtual System.Threading.Tasks.Task<Azure.Storage.Files.Shares.Models.CloseHandlesResult> ForceCloseAllHandlesAsync (bool? recursive = default, System.Threading.CancellationToken cancellationToken = default);

abstract member ForceCloseAllHandlesAsync : Nullable<bool> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Storage.Files.Shares.Models.CloseHandlesResult>
override this.ForceCloseAllHandlesAsync : Nullable<bool> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Storage.Files.Shares.Models.CloseHandlesResult>

Public Overridable Function ForceCloseAllHandlesAsync (Optional recursive As Nullable(Of Boolean) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of CloseHandlesResult)

パラメーター

recursive

Nullable<Boolean>

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

cancellationToken

CancellationToken

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

戻り値

Task<CloseHandlesResult>

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

注釈

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