Funzione FCIFlushCabinet (fci.h)
La funzione FCIFlushCabinet completa il gabinetto corrente.
Sintassi
BOOL DIAMONDAPI FCIFlushCabinet(
[in] HFCI hfci,
[in] BOOL fGetNextCab,
[in] PFNFCIGETNEXTCABINET pfnfcignc,
[in] PFNFCISTATUS pfnfcis
);
Parametri
[in] hfci
Handle di contesto fcI valido restituito dalla funzioneFCICreate .
[in] fGetNextCab
Specifica se verrà chiamata la funzione a cui fa riferimento il parametro GetNextCab fornito.
[in] pfnfcignc
Puntatore a una funzione di callback definita dall'applicazione per ottenere specifiche nel successivo gabinetto da creare. La funzione deve essere dichiarata usando la macro FNFCIGETNEXTCABINET .
[in] pfnfcis
Puntatore a una funzione di callback definita dall'applicazione per aggiornare l'utente. La funzione deve essere dichiarata usando la macro FNFCISTATUS .
Valore restituito
Se la funzione ha esito positivo, restituisce TRUE; in caso contrario, FALSE.
Le informazioni sugli errori estese vengono fornite nella struttura ERF usata per creare il contesto dell'istanza di fci.
Commenti
L'API FCIFlushCabinet forza il gabinetto corrente in fase di costruzione per essere completato immediatamente e quindi scritto su disco. Altre chiamate a FCIAddFile comportano l'aggiunta di file a un altro gabinetto.
Nel caso in cui l'archivio corrente abbia raggiunto il limite di dimensioni dei supporti specificato dall'applicazione, i dati in sospeso all'interno dei buffer interni di un'istanza di istanza verranno inseriti in un altro archivio.
Il flag fGetNextCab determina se la funzione puntata dal parametro GetNextCab verrà chiamata. Se fGetNextCab è impostato su TRUE, GetNextCab viene chiamato per ottenere informazioni di continuazione. Se FALSE, GetNextCab viene chiamato solo nell'evento in cui viene eseguito il overflow del cabinet.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | fci.h |
| Libreria | Cabinet.lib |
| DLL | Cabinet.dll |