Функция FCIFlushCabinet (fci.h)
Функция FCIFlushCabinet завершает текущий кабинет.
Синтаксис
BOOL DIAMONDAPI FCIFlushCabinet(
[in] HFCI hfci,
[in] BOOL fGetNextCab,
[in] PFNFCIGETNEXTCABINET pfnfcignc,
[in] PFNFCISTATUS pfnfcis
);
Параметры
[in] hfci
Допустимый дескриптор контекста FCI, возвращаемый функциейFCICreate .
[in] fGetNextCab
Указывает, будет ли вызываться функция, на которую указывает предоставленный параметр GetNextCab .
[in] pfnfcignc
Указатель на определяемую приложением функцию обратного вызова для получения спецификаций в следующем кабинете, который необходимо создать. Функция должна быть объявлена с помощью макроса FNFCIGETNEXTCABINET .
[in] pfnfcis
Указатель на определяемую приложением функцию обратного вызова для обновления пользователя. Функция должна быть объявлена с помощью макроса FNFCISTATUS .
Возвращаемое значение
Если функция выполняется успешно, возвращается значение TRUE; в противном случае — FALSE.
Расширенные сведения об ошибках предоставляются в структуре ERF , используемой для создания контекста FCI.
Комментарии
API FCIFlushCabinet принудительно выполняет немедленное завершение текущего шкафа, а затем записывается на диск. Дальнейшие вызовы FCIAddFile приведут к добавлению файлов в другой кабинет.
Если в текущем кабинете достигнут предельный размер носителя, заданный приложением, ожидающие данные во внутренних буферах FCI будут помещены в другой кабинет.
Флаг fGetNextCab определяет, будет ли вызываться функция, на которую указывает параметр GetNextCab . Если параметр fGetNextCab имеет значение TRUE, для получения сведений о продолжении вызывается GetNextCab . Если значение FALSE, getNextCab вызывается только в случае переполнения шкафа.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | fci.h |
| Библиотека | Cab.lib |
| DLL | Cabinet.dll |