ResetCompressor function (compressapi.h)

Prepares the compressor for the compression of a new stream. The compressor object retains properties set with SetCompressorInformation. The sequence of blocks generated is independent of previous blocks.

Syntax

BOOL ResetCompressor(
  [in] COMPRESSOR_HANDLE CompressorHandle
);

Parameters

[in] CompressorHandle

Handle to the compressor returned by CreateCompressor.

Return value

If the function succeeds, the return value is nonzero. If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

If the compression algorithm fails for some internal reason, the error from GetLastError can be ERROR_FUNCTION_FAILED. If the system cannot locate the compression algorithm handle, the error can be ERROR_INVALID_HANDLE.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 [desktop apps | UWP apps]
Target Platform Windows
Header compressapi.h
Library Cabinet.lib
DLL Cabinet.dll

See also

Compression API Functions