ShareFileClient.ForceCloseHandle(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:

ShareFileClient.cs

A ForceCloseHandle(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 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)

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

Response<CloseHandlesResult>

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

Comentários

Um RequestFailedException será gerado se ocorrer uma falha.