Partager via


ShareFileClient.ForceCloseHandleAsync(String, CancellationToken) Méthode

Définition

L’opération ForceCloseHandleAsync(String, CancellationToken) ferme un handle ouvert sur un fichier au niveau du service. Il prend en charge la fermeture d’un handle unique spécifié par handleId.

Cette API est destinée à être utilisée en même temps GetHandlesAsync(CancellationToken) que pour forcer la fermeture des handles qui bloquent les opérations. Ces descripteurs ont peut-être fuyé ou ont été perdus de trace par les clients SMB. L’API a un impact côté client sur la fermeture du handle, y compris les erreurs visibles par l’utilisateur en raison d’échecs de tentatives de lecture ou d’écriture de fichiers. Cette API n’est pas destinée à être utilisée comme remplacement ou alternative à la fermeture SMB.

Pour plus d'informations, consultez la rubrique Forcer la fermeture des poignées.

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

Paramètres

handleId
String

Spécifie l’ID de handle à fermer.

cancellationToken
CancellationToken

Facultatif CancellationToken pour propager des notifications indiquant que l’opération doit être annulée.

Retours

Response<T> décrivant le status de l’opérationForceCloseHandleAsync(String, CancellationToken).

Remarques

Un RequestFailedException est levée si une défaillance se produit.

S’applique à