FCIFlushFolder function

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

Syntax


BOOL FCIFlushFolder(
  _In_ HFCI                 hfci,
  _In_ PFNFCIGETNEXTCABINET GetNextCab,
  _In_ PFNFCISTATUS         pfnProgress
);

Parameters

hfci [in]

A valid FCI context handle returned by the FCICreate function.

GetNextCab [in]

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.

pfnProgress [in]

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.

Example

For an example, see Creating a Cabinet.

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

Header

Fci.h

Library

Cabinet.lib

DLL

Cabinet.dll

See also

FCIFlushCabinet

 

 

Show: