Função FCIFlushCabinet (fci.h)

A função FCIFlushCabinet conclui o gabinete atual.

Sintaxe

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

Parâmetros

[in] hfci

Um identificador de contexto fci válido retornado pela funçãoFCICreate .

[in] fGetNextCab

Especifica se a função apontada pelo parâmetro GetNextCab fornecido será chamada.

[in] pfnfcignc

Ponteiro para uma função de retorno de chamada definida pelo aplicativo para obter especificações no próximo gabinete a ser criado. A função deve ser declarada usando a macro FNFCIGETNEXTCABINET .

[in] pfnfcis

Ponteiro para uma função de retorno de chamada definida pelo aplicativo para atualizar o usuário. A função deve ser declarada usando a macro FNFCISTATUS .

Retornar valor

Se a função for bem-sucedida, ela retornará TRUE; caso contrário, FALSE.

Informações de erro estendidas são fornecidas na estrutura ERF usada para criar o contexto fci.

Comentários

A API FCIFlushCabinet força o gabinete atual em construção a ser concluído imediatamente e, em seguida, gravado em disco. Outras chamadas para FCIAddFile resultarão na adição de arquivos a outro gabinete.

Caso o gabinete atual tenha atingido o limite de tamanho de mídia especificado pelo aplicativo, os dados pendentes dentro dos buffers internos de uma FCI serão colocados em outro gabinete.

O sinalizador fGetNextCab determina se a função apontada pelo parâmetro GetNextCab será chamada. Se fGetNextCab estiver definido como TRUE, GetNextCab será chamado para obter informações de continuação. Se FALSE, GetNextCab será chamado somente no caso de o gabinete estourar.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	fci.h
Biblioteca	Cabinet.lib
DLL	Cabinet.dll

Confira também

FCIFlushFolder