FCIFlushCabinet-Funktion (fci.h)

Die FCIFlushCabinet-Funktion schließt den aktuellen Schrank ab.

Syntax

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

Parameter

[in] hfci

Ein gültiges FCI-Kontexthandle, das von derFCICreate-Funktion zurückgegeben wird.

[in] fGetNextCab

Gibt an, ob die Funktion aufgerufen wird, auf die der angegebene GetNextCab-Parameter verweist.

[in] pfnfcignc

Zeiger auf eine anwendungsdefinierte Rückruffunktion, um Spezifikationen für die nächste zu erstellende Ablage abzurufen. Die Funktion sollte mithilfe des FNFCIGETNEXTCABINET-Makros deklariert werden.

[in] pfnfcis

Zeiger auf eine anwendungsdefinierte Rückruffunktion, um den Benutzer zu aktualisieren. Die Funktion sollte mithilfe des FNFCISTATUS-Makros deklariert werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie TRUE zurück. andernfalls FALSE.

Erweiterte Fehlerinformationen werden in der ERF-Struktur bereitgestellt, die zum Erstellen des FCI-Kontexts verwendet wird.

Hinweise

Die FCIFlushCabinet-API erzwingt, dass der aktuelle Schaltschrank im Bau sofort fertig gestellt und dann auf den Datenträger geschrieben wird. Weitere Aufrufe von FCIAddFile führen dazu, dass Dateien einer anderen Ablage hinzugefügt werden.

Wenn die aktuelle Ablage die anwendungsspezifische Mediengrößenbegrenzung erreicht hat, werden die ausstehenden Daten innerhalb der internen Puffer einer FCI in einem anderen Schrank platziert.

Das fGetNextCab-Flag bestimmt, ob die Funktion aufgerufen wird, auf die der GetNextCab-Parameter verweist. Wenn fGetNextCabTRUE festgelegt ist, wird GetNextCab aufgerufen, um Fortsetzungsinformationen abzurufen. Wenn FALSE, wird GetNextCab nur aufgerufen, wenn die Ablage überläuft.

Anforderungen

Weitere Informationen

FCIFlushFolder