Partager via


FCIFlushCabinet, fonction (fci.h)

La fonction FCIFlushCabinet termine l’armoire actuelle.

Syntaxe

BOOL DIAMONDAPI FCIFlushCabinet(
  [in] HFCI                 hfci,
  [in] BOOL                 fGetNextCab,
  [in] PFNFCIGETNEXTCABINET pfnfcignc,
  [in] PFNFCISTATUS         pfnfcis
);

Paramètres

[in] hfci

Handle de contexte FCI valide retourné par la fonctionFCICreate .

[in] fGetNextCab

Spécifie si la fonction pointée vers par le paramètre GetNextCab fourni sera appelée.

[in] pfnfcignc

Pointeur vers une fonction de rappel définie par l’application pour obtenir des spécifications sur l’armoire suivante à créer. La fonction doit être déclarée à l’aide de la macro FNFCIGETNEXTCABINET .

[in] pfnfcis

Pointeur vers une fonction de rappel définie par l’application pour mettre à jour l’utilisateur. La fonction doit être déclarée à l’aide de la macro FNFCISTATUS .

Valeur retournée

Si la fonction réussit, elle retourne TRUE ; sinon, FALSE.

Les informations d’erreur étendues sont fournies dans la structure ERF utilisée pour créer le contexte FCI.

Remarques

L’API FCIFlushCabinet force l’exécution immédiate de l’armoire en cours de construction, puis son écriture sur le disque. D’autres appels à FCIAddFile entraînent l’ajout de fichiers à une autre armoire.

Si l’armoire actuelle a atteint la limite de taille de média spécifiée par l’application, les données en attente dans les mémoires tampons internes d’une instance de cluster de basculement sont placées dans une autre armoire.

L’indicateur fGetNextCab détermine si la fonction pointée vers le paramètre GetNextCab sera appelée. Si fGetNextCab est défini sur TRUE, GetNextCab est appelé pour obtenir des informations de continuation. Si la valeur est FALSE, GetNextCab est appelé uniquement en cas de dépassement de capacité de l’armoire.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête fci.h
Bibliothèque Cabinet.lib
DLL Cabinet.dll

Voir aussi

FCIFlushFolder