ShareFileClient.ForceCloseHandleAsync(String, CancellationToken) Método

Referência

Definição

Namespace:: Azure.Storage.Files.Shares

Assembly:: Azure.Storage.Files.Shares.dll

Pacote:: Azure.Storage.Files.Shares v12.18.0

Pacote:: Azure.Storage.Files.Shares v12.19.0-beta.1

Origem:: ShareFileClient.cs

Origem:: ShareFileClient.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

A ForceCloseHandleAsync(String, CancellationToken) operação fecha um identificador aberto em um arquivo no serviço. Ele dá suporte ao fechamento de um único identificador especificado por handleId.

Essa API destina-se a ser usada junto com GetHandlesAsync(CancellationToken) para forçar o fechamento de identificadores que bloqueiam operações. Esses identificadores podem ter vazado ou perdido o controle de por clientes SMB. A API tem impacto no lado do cliente no identificador que está sendo fechado, incluindo erros visíveis do usuário devido a tentativas com falha de ler ou gravar arquivos. Essa API não se destina a ser usada como uma substituição ou alternativa para fechamento de SMB.

Para obter mais informações, consulte Forçar fechar identificadores.

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))

Parâmetros

handleId: String

Especifica a ID do identificador a ser fechada.

cancellationToken: CancellationToken

Opcional CancellationToken para propagar notificações de que a operação deve ser cancelada.

Retornos

Task<Response<CloseHandlesResult>>

Um Response<T> que descreve o status da ForceCloseHandleAsync(String, CancellationToken) operação.

Comentários

Um RequestFailedException será gerado se ocorrer uma falha.

Aplica-se a

Compartilhar via