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

Consulte también

FCIAddFile

FCIDestroy

FCIFlushFolder