FCIFlushFolder function

The FCIFlushFolder function forces the current folder under construction to be completed immediately.

Syntax

BOOL DIAMONDAPI FCIFlushFolder(
  HFCI                 hfci,
  PFNFCIGETNEXTCABINET pfnfcignc,
  PFNFCISTATUS         pfnfcis
);

Parameters

hfci

A valid FCI context handle returned by the FCICreate function.

pfnfcignc

Pointer to an application-defined callback function to obtain specifications on the next cabinet to create. The function should be declared using the FNFCIGETNEXTCABINET macro.

pfnfcis

Pointer to an application-defined callback function to update the user. The function should be declared using the FNFCISTATUS macro.

Return Value

If the function succeeds, it returns TRUE; otherwise, FASLE.

Extended error information is provided in the ERF structure used to create the FCI context.

Remarks

The FCIFlushFolder API forces the folder currently under construction to be completed immediately; effectively resetting the compression history if a compression method is in use.

The callback function indicated by GetNextCab will be called if the cabinet overflows, which occurs if the pending data buffered inside an FCI causes the application-specified cabinet media size to be exceeded.

Requirements

   
Target Platform Windows
Header fci.h
Library Cabinet.lib
DLL Cabinet.dll

See Also

FCIFlushCabinet