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

Vedi anche

FCIFlushFolder