Función FCICreate (fci.h)
La función FCICreate crea un contexto de FCI.
Sintaxis
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
);
Parámetros
[in, out] perf
Puntero a una estructura ERF que recibe la información de error.
[in] pfnfcifp
Puntero a una función de devolución de llamada definida por la aplicación para notificar cuándo se coloca un archivo en el gabinete. La función se debe declarar mediante la macro FNFCIFILEPLACED .
[in] pfna
Puntero a una función de devolución de llamada definida por la aplicación para asignar memoria. La función se debe declarar mediante la macro FNFCIALLOC .
[in] pfnf
Puntero a una función de devolución de llamada definida por la aplicación para liberar memoria asignada previamente. La función debe declararse mediante la macro FNFCIFREE .
[in] pfnopen
Puntero a una función de devolución de llamada definida por la aplicación para abrir un archivo. La función se debe declarar mediante la macro FNFCIOPEN .
[in] pfnread
Puntero a una función de devolución de llamada definida por la aplicación para leer datos de un archivo. La función se debe declarar mediante la macro FNFCIREAD .
[in] pfnwrite
Puntero a una función de devolución de llamada definida por la aplicación para escribir datos en un archivo. La función se debe declarar mediante la macro FNFCIWRITE .
[in] pfnclose
Puntero a una función de devolución de llamada definida por la aplicación para cerrar un archivo. La función debe declararse mediante la macro FNFCICLOSE .
[in] pfnseek
Puntero a una función de devolución de llamada definida por la aplicación para mover un puntero de archivo a la ubicación específica. La función se debe declarar mediante la macro FNFCISEEK .
[in] pfndelete
Puntero a una función de devolución de llamada definida por la aplicación para eliminar un archivo. La función se debe declarar mediante la macro FNFCIDELETE .
[in] pfnfcigtf
Puntero a una función de devolución de llamada definida por la aplicación para recuperar un nombre de archivo temporal. La función debe declararse mediante la macro FNFCIGETTEMPFILE .
[in] pccab
Puntero a una estructura CCAB que contiene los parámetros para crear un gabinete.
[in, optional] pv
Puntero a un valor definido por la aplicación que se pasa a las funciones de devolución de llamada.
Valor devuelto
Si la función se realiza correctamente, devuelve un puntero de contexto HFCI distinto de NULL ; en caso contrario, NULL.
La información de error extendida se proporciona en la estructura ERF .
Comentarios
FCI admite varios contextos simultáneos. Como resultado, es posible crear o extraer varios gabinetes al mismo tiempo dentro de la misma aplicación. Si la aplicación es multiproceso, también es posible ejecutar un contexto diferente en cada subproceso; sin embargo, una aplicación no puede usar el mismo contexto simultáneamente en varios subprocesos. Por ejemplo, no se puede llamar a FCIAddFile desde dos subprocesos diferentes, con el mismo contexto de FCI.
Requisitos
| Plataforma de destino | Windows |
| Encabezado | fci.h |
| Library | Cabinet.lib |
| Archivo DLL | Cabinet.dll |