LZSeek-Funktion (lzexpand.h)

Artikel
03/01/2024

Verschiebt einen Dateizeiger um die angegebene Anzahl von Bytes von einer Anfangsposition.

Syntax

LONG LZSeek(
  [in] INT  hFile,
  [in] LONG lOffset,
  [in] INT  iOrigin
);

Parameter

[in] hFile

Ein Handle zur Datei.

[in] lOffset

Die Anzahl der Bytes, um die der Dateizeiger verschoben werden soll.

[in] iOrigin

Die Startposition des Zeigers. Dieser Parameter muss einen der folgenden Werte aufweisen.

Wert	Bedeutung
0	Verschiebt den Dateizeiger lOffset Bytes vom Anfang der Datei.
1	Verschiebt den Dateizeiger lOffset Bytes von der aktuellen Position.
2	Verschiebt den Dateizeiger lOffset Bytes vom Ende der Datei.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt der Rückgabewert den Offset vom Anfang der Datei bis zur neuen Zeigerposition an.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein LZERROR_*-Code. Diese Codes weisen Werte kleiner als 0 (null) auf. Beachten Sie, dass LZSeek weder SetLastError noch SetLastErrorEx aufruft. Daher wirkt sich der Fehler nicht auf den Code des letzten Fehlers eines Threads aus.

Im Folgenden finden Sie die Liste der Fehlercodes, die LZSeek bei einem Fehler zurückgeben kann.

Rückgabecode	Beschreibung
LZERROR_BADINHANDLE	Das Handle, das die Quelldatei identifiziert, ist ungültig. Die Datei kann nicht gelesen werden.
LZERROR_BADVALUE	Einer der Parameter liegt außerhalb des Bereichs der zulässigen Werte.
LZERROR_GLOBLOCK	Das LZ-Dateihandle kann nicht gesperrt werden.

Es gibt keine erweiterten Fehlerinformationen für diese Funktion. Rufen Sie GetLastError nicht auf.

Hinweise

Das durch den hFile-Parameter identifizierte Handle muss entweder durch Aufrufen der Funktion LZInit oder LZOpenFile abgerufen werden.

Unter Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.

Technologie	Unterstützt
SMB 3.0-Protokoll (Server Message Block)	Ja
SMB 3.0 Transparent Failover (TFO)	Ja
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO)	Ja
Dateisystem mit freigegebenen Clustervolumes (CsvFS)	Ja
Robustes Dateisystem (Resilient File System, ReFS)	Ja

CsvFs leiten E/A für komprimierte Dateien um.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	lzexpand.h (windows.h einschließen)
Bibliothek	Lz32.lib
DLL	Lz32.dll

Weitere Informationen

Komprimierung und Dekomprimierung von Dateien

Dateiverwaltungsfunktionen

LZInit

LZOpenFile

Freigeben über