FsRtlFastUnlockSingle-Funktion (ntifs.h)

  • Artikel

Die FsRtlFastUnlockSingle-Routine gibt eine Bytebereichssperre frei, die vom angegebenen Prozess mit dem angegebenen Schlüsselwert, Dateioffset und Länge für eine Datei abgerufen wurde.

Syntax

NTSTATUS FsRtlFastUnlockSingle(
  [in]           PFILE_LOCK     FileLock,
  [in]           PFILE_OBJECT   FileObject,
  [in]           LARGE_INTEGER  *FileOffset,
  [in]           PLARGE_INTEGER Length,
  [in]           PEPROCESS      ProcessId,
  [in]           ULONG          Key,
  [in, optional] PVOID          Context,
  [in]           BOOLEAN        AlreadySynchronized
);

Parameter

[in] FileLock

Ein Zeiger auf die FILE_LOCK Struktur für die Datei. Diese Struktur muss durch einen vorherigen Aufruf von FsRtlAllocateFileLock oder FsRtlInitializeFileLock initialisiert worden sein.

[in] FileObject

Ein Zeiger auf das Dateiobjekt für die Datei.

[in] FileOffset

Ein Zeiger auf eine Variable, der den Anfangsbyteoffset in der Datei des zu entsperrenden Bereichs angibt.

[in] Length

Ein Zeiger auf eine Variable, die die Länge des zu entsperrenden Bereichs in Bytes angibt.

[in] ProcessId

Ein Zeiger auf die Prozess-ID für den Prozess.

[in] Key

Der Schlüssel für die Bytebereichssperre.

[in, optional] Context

Ein optionaler Kontextzeiger, der beim Abschließen von IRPs verwendet werden soll.

[in] AlreadySynchronized

Dieser Parameter ist veraltet, wird aber aus Gründen der Kompatibilität mit Legacytreibern beibehalten.

Rückgabewert

Die FsRtlFastUnlockSingle-Routine gibt STATUS_SUCCESS oder einen Fehler status Code wie STATUS_RANGE_NOT_LOCKED zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000
Zielplattform Universell
Header ntifs.h (include FltKernel.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL
DDI-Complianceregeln HwStorPortProhibitedDDIs(storport)

Weitere Informationen

FsRtlAllocateFileLock

FsRtlInitializeFileLock