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 |
|
|---|
See also