ShareDirectoryClient.ForceCloseHandleAsync(String, CancellationToken) メソッド

定義

名前空間:

Azure.Storage.Files.Shares

アセンブリ:

Azure.Storage.Files.Shares.dll

パッケージ:

Azure.Storage.Files.Shares v12.18.0

ソース:

ShareDirectoryClient.cs

操作は ForceCloseHandle(String, CancellationToken) 、サービスのディレクトリまたはファイルで開かれたハンドルを閉じます。 では、 で指定された 1 つのハンドルを閉じることが handleIdサポートされています。

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

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

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Files.Shares.Models.CloseHandlesResult>> ForceCloseHandleAsync (string handleId, System.Threading.CancellationToken cancellationToken = default);

abstract member ForceCloseHandleAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Files.Shares.Models.CloseHandlesResult>>
override this.ForceCloseHandleAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Files.Shares.Models.CloseHandlesResult>>

Public Overridable Function ForceCloseHandleAsync (handleId As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of CloseHandlesResult))

パラメーター

handleId

String

閉じるハンドル ID を指定します。

cancellationToken

CancellationToken

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

戻り値

Task<Response<CloseHandlesResult>>

Response<T>操作の状態を記述する ForceCloseHandleAsync(String, CancellationToken) 。

注釈

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