Funzione FCICreate (fci.h)

La funzione FCICreate crea un contesto fcI.

Sintassi

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
);

Parametri

[in, out] perf

Puntatore a una struttura ERF che riceve le informazioni sull'errore.

[in] pfnfcifp

Puntatore a una funzione di callback definita dall'applicazione per notificare quando un file viene inserito nel gabinetto. La funzione deve essere dichiarata usando la macro FNFCIFILEPLACED .

[in] pfna

Puntatore a una funzione di callback definita dall'applicazione per allocare memoria. La funzione deve essere dichiarata usando la macro FNFCIALLOC .

[in] pfnf

Puntatore a una funzione di callback definita dall'applicazione per liberare memoria precedentemente allocata. La funzione deve essere dichiarata usando la macro FNFCIFREE .

[in] pfnopen

Puntatore a una funzione di callback definita dall'applicazione per aprire un file. La funzione deve essere dichiarata usando la macro FNFCIOPEN .

[in] pfnread

Puntatore a una funzione di callback definita dall'applicazione per leggere i dati da un file. La funzione deve essere dichiarata usando la macro FNFCIREAD .

[in] pfnwrite

Puntatore a una funzione di callback definita dall'applicazione per scrivere dati in un file. La funzione deve essere dichiarata usando la macro FNFCIWRITE .

[in] pfnclose

Puntatore a una funzione di callback definita dall'applicazione per chiudere un file. La funzione deve essere dichiarata usando la macro FNFCICLOSE .

[in] pfnseek

Puntatore a una funzione di callback definita dall'applicazione per spostare un puntatore di file alla posizione specifica. La funzione deve essere dichiarata usando la macro FNFCISEEK .

[in] pfndelete

Puntatore a una funzione di callback definita dall'applicazione per eliminare un file. La funzione deve essere dichiarata usando la macro FNFCIDELETE .

[in] pfnfcigtf

Puntatore a una funzione di callback definita dall'applicazione per recuperare un nome file temporaneo. La funzione deve essere dichiarata usando la macro FNFCIGETTEMPFILE .

[in] pccab

Puntatore a una struttura CCAB che contiene i parametri per la creazione di un archivio.

[in, optional] pv

Puntatore a un valore definito dall'applicazione passato alle funzioni di callback.

Valore restituito

Se la funzione ha esito positivo, restituisce un puntatore del contesto HFCI non NULL ; in caso contrario, NULL.

Le informazioni sugli errori estese vengono fornite nella struttura ERF .

Commenti

FcI supporta più contesti simultanei. Di conseguenza, è possibile creare o estrarre più cabinet contemporaneamente all'interno della stessa applicazione. Se l'applicazione è multithreaded, è anche possibile eseguire un contesto diverso in ogni thread; tuttavia, un'applicazione non può usare lo stesso contesto contemporaneamente in più thread. Ad esempio, FCIAddFile non può essere chiamato da due thread diversi, usando lo stesso contesto di FCI.

Requisiti

Vedi anche

FCIAddFile

FCIDestroy

FCIFlushFolder