ShareDirectoryClient.ForceCloseHandleAsync(String, CancellationToken) Método

Definição

Namespace:

Azure.Storage.Files.Shares

Assembly:

Azure.Storage.Files.Shares.dll

Pacote:

Azure.Storage.Files.Shares v12.18.0

Origem:

ShareDirectoryClient.cs

A ForceCloseHandle(String, CancellationToken) operação fecha um identificador aberto em um diretório ou 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(Nullable<Boolean>, CancellationToken) para forçar o fechamento de identificadores que bloqueiam operações, como renomear um diretório. 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.