LZInit-Funktion (lzexpand.h)

  • Artikel

Reserviert Arbeitsspeicher für die internen Datenstrukturen, die zum Dekomprimieren von Dateien erforderlich sind, und erstellt und initialisiert sie dann.

Syntax

INT LZInit(
  [in] INT hfSource
);

Parameter

[in] hfSource

Ein Handle zur Datei.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein neues LZ-Dateihandle.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein LZERROR_*-Code. Diese Codes haben Werte kleiner als 00. Beachten Sie, dass LZInit weder SetLastError noch SetLastErrorEx aufruft. daher wirkt sich sein Fehler nicht auf den Code des letzten Fehlers eines Threads aus.

Im Folgenden finden Sie die Liste der Fehlercodes, die LZInit 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_GLOBALLOC
 Die maximale Anzahl geöffneter komprimierter Dateien wurde überschritten, oder der lokale Arbeitsspeicher kann nicht zugewiesen werden.
LZERROR_GLOBLOCK
 Das LZ-Dateihandle kann nicht gesperrt werden.
LZERROR_UNKNOWNALG
 Die Datei wird mit einem nicht erkannten Komprimierungsalgorithmus komprimiert.
 

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

Hinweise

Maximal 16 komprimierte Dateien können jederzeit geöffnet werden. Ebenso können maximal 16 unkomprimierte Dateien jederzeit geöffnet werden. Eine Anwendung sollte darauf achten, das von LZInit zurückgegebene Handle zu schließen, wenn die Datei verwendet wird. andernfalls kann die Anwendung versehentlich das Limit von 16 Dateien erreichen.

Der von dieser Funktion zurückgegebene Handle ist nur mit den Funktionen in Lz32.dll kompatibel. Es sollte nicht für andere Dateivorgänge verwendet 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

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

Weitere Informationen

Komprimierung und Dekomprimierung von Dateien

Dateiverwaltungsfunktionen