ResetCompressor-Funktion (compressapi.h)

Bereitet den Kompressor für die Komprimierung eines neuen Datenstroms vor. Das Compressor-Objekt behält eigenschaften bei, die mit SetCompressorInformation festgelegt sind. Die Sequenz der generierten Blöcke ist unabhängig von vorherigen Blöcken.

Syntax

BOOL ResetCompressor(
  [in] COMPRESSOR_HANDLE CompressorHandle
);

Parameter

[in] CompressorHandle

Handle an den Kompressor, der von CreateCompressor zurückgegeben wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null. Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn der Komprimierungsalgorithmus aus einem internen Grund fehlschlägt, kann der Fehler von GetLastErrorERROR_FUNCTION_FAILED werden. Wenn das System das Komprimierungsalgorithmushandle nicht finden kann, kann der Fehler ERROR_INVALID_HANDLE werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile compressapi.h
Bibliothek Cabinet.lib
DLL Cabinet.dll

Weitere Informationen

Komprimierungs-API-Funktionen