ShareDirectoryClient.ForceCloseAllHandlesAsync 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 ForceCloseAllHandlesAsync(Nullable<Boolean>, CancellationToken) operação fecha todos os identificadores abertos em um diretório ou um arquivo no serviço. Opcionalmente, ele dá suporte ao fechamento recursivo de identificadores em sub-recursos quando o recurso é um diretório.

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.

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

public virtual System.Threading.Tasks.Task<Azure.Storage.Files.Shares.Models.CloseHandlesResult> ForceCloseAllHandlesAsync (bool? recursive = default, System.Threading.CancellationToken cancellationToken = default);

abstract member ForceCloseAllHandlesAsync : Nullable<bool> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Storage.Files.Shares.Models.CloseHandlesResult>
override this.ForceCloseAllHandlesAsync : Nullable<bool> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Storage.Files.Shares.Models.CloseHandlesResult>

Public Overridable Function ForceCloseAllHandlesAsync (Optional recursive As Nullable(Of Boolean) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of CloseHandlesResult)

Parâmetros

recursive

Nullable<Boolean>

Opcional. Um valor booliano que especifica se a operação também deve ser aplicada aos arquivos e subdiretórios do diretório especificado.

cancellationToken

CancellationToken

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

Retornos

Task<CloseHandlesResult>

Um CloseHandlesResult que descreve o status da ForceCloseAllHandlesAsync(Nullable<Boolean>, CancellationToken) operação.

Comentários

Um RequestFailedException será gerado se ocorrer uma falha.