ShareDirectoryClient.ForceCloseAllHandlesAsync Methode

Definition

Namespace:

Azure.Storage.Files.Shares

Assembly:

Azure.Storage.Files.Shares.dll

Paket:

Azure.Storage.Files.Shares v12.18.0

Quelle:

ShareDirectoryClient.cs

Der ForceCloseAllHandlesAsync(Nullable<Boolean>, CancellationToken) Vorgang schließt alle Handles, die in einem Verzeichnis oder einer Datei im Dienst geöffnet werden. Optional werden rekursiv schließende Handles für Unterressourcen unterstützt, wenn die Ressource ein Verzeichnis ist.

Diese API soll zusammen GetHandlesAsync(Nullable<Boolean>, CancellationToken) verwendet werden, um schließende Handles zu erzwingen, die Vorgänge blockieren, z. B. das Umbenennen eines Verzeichnisses. 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.Storage.Files.Shares.Models.CloseHandlesResult> ForceCloseAllHandlesAsync (bool? recursive = default, System.Threading.CancellationToken cancellationToken = default);

abstract member ForceCloseAllHandlesAsync : Nullable<bool> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Storage.Files.Shares.Models.CloseHandlesResult>
override this.ForceCloseAllHandlesAsync : Nullable<bool> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Storage.Files.Shares.Models.CloseHandlesResult>

Public Overridable Function ForceCloseAllHandlesAsync (Optional recursive As Nullable(Of Boolean) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of CloseHandlesResult)

Parameter

recursive

Nullable<Boolean>

Optional. Ein boolescher Wert, der angibt, ob der Vorgang auch für die Dateien und Unterverzeichnisse des angegebenen Verzeichnisses gelten soll.

cancellationToken

CancellationToken

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

Gibt zurück

Task<CloseHandlesResult>

Ein CloseHandlesResult , der die status des Vorgangs ForceCloseAllHandlesAsync(Nullable<Boolean>, CancellationToken) beschreibt.

Hinweise

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