Partager via


ShareFileClient.ForceCloseHandle(String, CancellationToken) Méthode

Définition

L’opération ForceCloseHandle(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 handles peuvent avoir été divulgués ou perdus de trace par les clients SMB. L’API a un impact côté client sur le handle en cours de fermeture, 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 pour la fermeture SMB.

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

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)

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érationForceCloseHandle(String, CancellationToken).

Remarques

Un RequestFailedException sera levée en cas d’échec.

S’applique à