FNFCIGETNEXTCABINET macro

The FNFCIGETNEXTCABINET macro provides the declaration for the application-defined callback function to request information for the next cabinet.

Syntax


BOOL FNFCIGETNEXTCABINET(
   PCCAB    pccab,
   ULONG    cbPrevCab,
   void FAR *pv
);

Parameters

pccab

Pointer to a CCAB structure to provide the parameters for the creation of a new cabinet.

cbPrevCab

Size, in bytes, of the previous cabinet.

pv

Pointer to an application-defined value.

Return value

The indicated callback function returns TRUE if successful; otherwise FALSE.

Remarks

The CCAB structure referenced by this function is relevant to the most recently completed cabinet. However, with each successful operation the iCab field contained within this structure will have incremented by 1. Additionally, the next cabinet will be created using the fields in this structure. The szCab, in particular, should be modified as necessary. In particular, the szCab field, which specifies the cabinet name, should be changed for each cabinet.

When creating multiple cabinets, typically the iCab field is used to create the name.

Examples


FNFCIGETNEXTCABINET(fnGetNextCabinet)
{
    HRESULT hr;

    UNREFERENCED_PARAMETER(pv);
    UNREFERENCED_PARAMETER(cbPrevCab);
    
    hr = StringCchPrintfA(pccab->szCab,
                          ARRAYSIZE(pccab->szCab),
                          "FCISample%02d.cab",
                          pccab->iCab);
        
    return ( SUCCEEDED(hr) );
}


Requirements

Header

Fci.h

See also

FCICreate

 

 

Show: