Share via


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

定義

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

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

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

public virtual Azure.Response<Azure.Storage.Files.Shares.Models.CloseHandlesResult> ForceCloseHandle (string handleId, System.Threading.CancellationToken cancellationToken = default);
abstract member ForceCloseHandle : string * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Files.Shares.Models.CloseHandlesResult>
override this.ForceCloseHandle : string * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Files.Shares.Models.CloseHandlesResult>
Public Overridable Function ForceCloseHandle (handleId As String, Optional cancellationToken As CancellationToken = Nothing) As Response(Of CloseHandlesResult)

パラメーター

handleId
String

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

cancellationToken
CancellationToken

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

戻り値

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

注釈

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

適用対象