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
指向传递给回调函数的应用程序定义值的指针。
返回值
如果函数成功，则返回非 NULL HFCI 上下文指针;否则为 NULL。
ERF 结构中提供了扩展错误信息。
备注
FCI 支持多个同时出现的上下文。 因此，可以在同一应用程序中同时创建或提取多个文件柜。 如果应用程序是多线程的，则还可以在每个线程中运行不同的上下文;但是，应用程序不能在多个线程中同时使用同一上下文。 例如，不能使用相同的 FCI 上下文从两个不同的线程调用 FCIAddFile 。
要求
| 目标平台 | Windows |
| 标头 | fci.h |
| Library | Cabinet.lib |
| DLL | Cabinet.dll |