ShareFileClient.ForceCloseHandleAsync(String, CancellationToken) Methode

Referenz

Definition

Namespace:: Azure.Storage.Files.Shares

Assembly:: Azure.Storage.Files.Shares.dll

Paket:: Azure.Storage.Files.Shares v12.18.0

Paket:: Azure.Storage.Files.Shares v12.19.0-beta.1

Quelle:: ShareFileClient.cs

Quelle:: ShareFileClient.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Der ForceCloseHandleAsync(String, CancellationToken) Vorgang schließt ein Handle, das für eine Datei im Dienst geöffnet wurde. Es unterstützt das Schließen eines einzelnen Handles, das von angegeben wird handleId.

Diese API soll zusammen GetHandlesAsync(CancellationToken) verwendet werden, um schließende Handles zu erzwingen, die Vorgänge blockieren. Diese Handles sind möglicherweise durch SMB-Clients kompromittiert oder verloren gegangen. Die API hat clientseitige Auswirkungen auf das zu schließende Handle, einschließlich sichtbarer Benutzerfehler aufgrund fehlgeschlagener Versuche, Dateien zu lesen oder zu schreiben. Diese API ist nicht für die Verwendung als Ersatz oder Alternative für den SMB-Schließen vorgesehen.

Weitere Informationen finden Sie unter Schließen von Handles erzwingen.

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

Parameter

handleId: String

Gibt die zu schließende Handle-ID an.

cancellationToken: CancellationToken

Optional CancellationToken zur Weitergabe von Benachrichtigungen, dass der Vorgang abgebrochen werden soll.

Gibt zurück

Task<Response<CloseHandlesResult>>

Ein Response<T> , der die status des Vorgangs ForceCloseHandleAsync(String, CancellationToken) beschreibt.

Hinweise

Ein RequestFailedException wird ausgelöst, wenn ein Fehler auftritt.

Gilt für:

Freigeben über