ShareFileClient.ForceCloseHandleAsync(String, CancellationToken) Méthode

Définition

Espace de noms:

Azure.Storage.Files.Shares

Assembly:

Azure.Storage.Files.Shares.dll

Paquet:

Azure.Storage.Files.Shares v12.18.0

Source:

ShareFileClient.cs

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

Task<Response<CloseHandlesResult>>

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

Remarques

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