FCIFlushFolder function (fci.h)
The FCIFlushFolder function forces the current folder under construction to be completed immediately.
BOOL DIAMONDAPI FCIFlushFolder( [in] HFCI hfci, [in] PFNFCIGETNEXTCABINET pfnfcignc, [in] PFNFCISTATUS pfnfcis );
A valid FCI context handle returned by the FCICreate function.
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.
Pointer to an application-defined callback function to update the user. The function should be declared using the FNFCISTATUS macro.
If the function succeeds, it returns TRUE; otherwise, FALSE.
Extended error information is provided in the ERF structure used to create the FCI context.
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.