Функция FCICreate (fci.h)
Функция FCICreate создает контекст FCI.
Синтаксис
HFCI DIAMONDAPI FCICreate(
[in, out] PERF perf,
[in] PFNFCIFILEPLACED pfnfcifp,
[in] PFNFCIALLOC pfna,
[in] PFNFCIFREE pfnf,
[in] PFNFCIOPEN pfnopen,
[in] PFNFCIREAD pfnread,
[in] PFNFCIWRITE pfnwrite,
[in] PFNFCICLOSE pfnclose,
[in] PFNFCISEEK pfnseek,
[in] PFNFCIDELETE pfndelete,
[in] PFNFCIGETTEMPFILE pfnfcigtf,
[in] PCCAB pccab,
[in, optional] void *pv
);
Параметры
[in, out] perf
Указатель на структуру ERF , которая получает сведения об ошибке.
[in] pfnfcifp
Указатель на определяемую приложением функцию обратного вызова для уведомления о размещении файла в шкафу. Функция должна быть объявлена с помощью макроса FNFCIFILEPLACED .
[in] pfna
Указатель на определяемую приложением функцию обратного вызова для выделения памяти. Функция должна быть объявлена с помощью макроса FNFCIALLOC .
[in] pfnf
Указатель на определяемую приложением функцию обратного вызова для освобождения ранее выделенной памяти. Функция должна быть объявлена с помощью макроса FNFCIFREE .
[in] pfnopen
Указатель на определяемую приложением функцию обратного вызова для открытия файла. Функция должна быть объявлена с помощью макроса FNFCIOPEN .
[in] pfnread
Указатель на определяемую приложением функцию обратного вызова для чтения данных из файла. Функция должна быть объявлена с помощью макроса FNFCIREAD .
[in] pfnwrite
Указатель на определяемую приложением функцию обратного вызова для записи данных в файл. Функция должна быть объявлена с помощью макроса FNFCIWRITE .
[in] pfnclose
Указатель на определяемую приложением функцию обратного вызова для закрытия файла. Функция должна быть объявлена с помощью макроса FNFCICLOSE .
[in] pfnseek
Указатель на определяемую приложением функцию обратного вызова для перемещения указателя на файл в определенное расположение. Функция должна быть объявлена с помощью макроса FNFCISEEK .
[in] pfndelete
Указатель на определяемую приложением функцию обратного вызова для удаления файла. Функция должна быть объявлена с помощью макроса FNFCIDELETE .
[in] pfnfcigtf
Указатель на определяемую приложением функцию обратного вызова для получения временного имени файла. Функция должна быть объявлена с помощью макроса FNFCIGETTEMPFILE .
[in] pccab
Указатель на структуру CCAB , содержащую параметры для создания шкафа.
[in, optional] pv
Указатель на определяемое приложением значение, которое передается в функции обратного вызова.
Возвращаемое значение
Если функция выполняется успешно, она возвращает указатель контекста HFCI, отличный от NULL ; в противном случае — NULL.
Расширенные сведения об ошибке предоставляются в структуре ERF .
Комментарии
FCI поддерживает несколько одновременных контекстов. В результате можно создать или извлечь несколько шкафов одновременно в одном приложении. Если приложение является многопотоком, в каждом потоке также можно запускать разные контексты; однако приложение не может одновременно использовать один и тот же контекст в нескольких потоках. Например, FCIAddFile нельзя вызвать из двух разных потоков, используя один и тот же контекст FCI.
Требования
| Целевая платформа | Windows |
| Header | fci.h |
| Библиотека | Cab.lib |
| DLL | Cabinet.dll |