Función FCIFlushCabinet (fci.h)
La función FCIFlushCabinet completa el gabinete actual.
Sintaxis
BOOL DIAMONDAPI FCIFlushCabinet(
[in] HFCI hfci,
[in] BOOL fGetNextCab,
[in] PFNFCIGETNEXTCABINET pfnfcignc,
[in] PFNFCISTATUS pfnfcis
);
Parámetros
[in] hfci
Identificador de contexto de FCI válido devuelto por la funciónFCICreate .
[in] fGetNextCab
Especifica si se llamará a la función a la que apunta el parámetro GetNextCab proporcionado.
[in] pfnfcignc
Puntero a una función de devolución de llamada definida por la aplicación para obtener especificaciones en el siguiente gabinete que se va a crear. La función se debe declarar mediante la macro FNFCIGETNEXTCABINET .
[in] pfnfcis
Puntero a una función de devolución de llamada definida por la aplicación para actualizar al usuario. La función debe declararse mediante la macro FNFCISTATUS .
Valor devuelto
Si la función se realiza correctamente, devuelve TRUE; de lo contrario, FALSE.
La información de error extendida se proporciona en la estructura ERF utilizada para crear el contexto de FCI.
Comentarios
La API FCIFlushCabinet obliga a que el gabinete actual en construcción se complete inmediatamente y luego se escriba en el disco. Las llamadas adicionales a FCIAddFile darán lugar a que los archivos se agreguen a otro gabinete.
En caso de que el gabinete actual haya alcanzado el límite de tamaño de medios especificado por la aplicación, los datos pendientes dentro de los búferes internos de una FCI se colocarán en otro gabinete.
La marca fGetNextCab determina si se llamará a la función a la que apunta el parámetro GetNextCab . Si fGetNextCab se establece en TRUE, se llama a GetNextCab para obtener información de continuación. Si es FALSE, solo se llama a GetNextCab en caso de que el gabinete se desborde.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | fci.h |
| Library | Cabinet.lib |
| Archivo DLL | Cabinet.dll |