LZCopy-Funktion (lzexpand.h)

Kopiert eine Quelldatei in eine Zieldatei. Wenn die Quelldatei vom Lempel-Ziv-Algorithmus komprimiert wurde, erstellt diese Funktion eine dekomprimierte Zieldatei. Wenn die Quelldatei nicht komprimiert ist, dupliziert diese Funktion die ursprüngliche Datei.

Syntax

LONG LZCopy(
  [in] INT hfSource,
  [in] INT hfDest
);

Parameter

[in] hfSource

Ein Handle für die Quelldatei.

[in] hfDest

Ein Handle für die Zieldatei.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt der Rückgabewert die Größe der Zieldatei in Bytes an.

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

Im Folgenden finden Sie eine Liste der Fehlercodes, die LZCopy 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_BADOUTHANDLE	Das Handle, das die Zieldatei identifiziert, ist ungültig. Die Datei kann nicht geschrieben 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_READ	Das Quelldateiformat ist ungültig.

 

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

Hinweise

Die Handles, die die Quell- und Zieldateien identifizieren, müssen durch Aufrufen der Funktion LZInit oder LZOpenFile abgerufen werden.

Wenn die Funktion erfolgreich ist, wird die durch den parameter hfDest identifizierte Datei immer nicht komprimiert.

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

LZInit

LZOpenFile