FCICreate, fonction (fci.h)

La fonction FCICreate crée un contexte FCI.

Syntaxe

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

Paramètres

[in, out] perf

Pointeur vers une structure ERF qui reçoit les informations d’erreur.

[in] pfnfcifp

Pointeur vers une fonction de rappel définie par l’application pour notifier lorsqu’un fichier est placé dans l’armoire. La fonction doit être déclarée à l’aide de la macro FNFCIFILEPLACED .

[in] pfna

Pointeur vers une fonction de rappel définie par l’application pour allouer de la mémoire. La fonction doit être déclarée à l’aide de la macro FNFCIALLOC .

[in] pfnf

Pointeur vers une fonction de rappel définie par l’application pour libérer de la mémoire précédemment allouée. La fonction doit être déclarée à l’aide de la macro FNFCIFREE .

[in] pfnopen

Pointeur vers une fonction de rappel définie par l’application pour ouvrir un fichier. La fonction doit être déclarée à l’aide de la macro FNFCIOPEN .

[in] pfnread

Pointeur vers une fonction de rappel définie par l’application pour lire les données d’un fichier. La fonction doit être déclarée à l’aide de la macro FNFCIREAD .

[in] pfnwrite

Pointeur vers une fonction de rappel définie par l’application pour écrire des données dans un fichier. La fonction doit être déclarée à l’aide de la macro FNFCIWRITE .

[in] pfnclose

Pointeur vers une fonction de rappel définie par l’application pour fermer un fichier. La fonction doit être déclarée à l’aide de la macro FNFCICLOSE .

[in] pfnseek

Pointeur vers une fonction de rappel définie par l’application pour déplacer un pointeur de fichier vers l’emplacement spécifique. La fonction doit être déclarée à l’aide de la macro FNFCISEEK .

[in] pfndelete

Pointeur vers une fonction de rappel définie par l’application pour supprimer un fichier. La fonction doit être déclarée à l’aide de la macro FNFCIDELETE .

[in] pfnfcigtf

Pointeur vers une fonction de rappel définie par l’application pour récupérer un nom de fichier temporaire. La fonction doit être déclarée à l’aide de la macro FNFCIGETTEMPFILE .

[in] pccab

Pointeur vers une structure CCAB qui contient les paramètres de création d’une armoire.

[in, optional] pv

Pointeur vers une valeur définie par l’application qui est passée aux fonctions de rappel.

Valeur retournée

Si la fonction réussit, elle retourne un pointeur de contexte HFCI non NULL ; sinon, NULL.

Les informations d’erreur étendues sont fournies dans la structure ERF .

Notes

FCI prend en charge plusieurs contextes simultanés. Par conséquent, il est possible de créer ou d’extraire plusieurs armoires en même temps dans la même application. Si l’application est multithread, il est également possible d’exécuter un contexte différent dans chaque thread ; Toutefois, une application ne peut pas utiliser le même contexte simultanément dans plusieurs threads. Par exemple, FCIAddFile ne peut pas être appelé à partir de deux threads différents, en utilisant le même contexte FCI.

Spécifications

Voir aussi

FCIAddFile

FCIDestroy

FCIFlushFolder