你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

ShareFileClient.ForceCloseHandleAsync(String, CancellationToken) 方法

定义

命名空间:

Azure.Storage.Files.Shares

程序集:

Azure.Storage.Files.Shares.dll

包:

Azure.Storage.Files.Shares v12.18.0

Source:

ShareFileClient.cs

该 ForceCloseHandleAsync(String, CancellationToken) 操作关闭在服务的文件上打开的句柄。 它支持关闭 指定的 handleId单个句柄。

此 API 旨在与一起使用 GetHandlesAsync(CancellationToken) ，以强制关闭阻止操作的句柄。 SMB 客户端可能已泄漏或丢失这些句柄的跟踪。 API 对正在关闭的句柄具有客户端影响，包括由于读取或写入文件尝试失败而导致的用户可见错误。 此 API 不用作 SMB 关闭的替换或替代项。

有关详细信息，请参阅 强制关闭句柄。

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如果发生故障，将引发 。