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
| Piattaforma di destinazione | Windows |
| Intestazione | fci.h |
| Libreria | Cabinet.lib |
| DLL | Cabinet.dll |