Função FCIAddFile (fci.h)

O FCIAddFile adiciona um arquivo ao gabinete em construção.

Sintaxe

BOOL DIAMONDAPI FCIAddFile(
  [in] HFCI                 hfci,
  [in] LPSTR                pszSourceFile,
  [in] LPSTR                pszFileName,
  [in] BOOL                 fExecute,
  [in] PFNFCIGETNEXTCABINET pfnfcignc,
  [in] PFNFCISTATUS         pfnfcis,
  [in] PFNFCIGETOPENINFO    pfnfcigoi,
  [in] TCOMP                typeCompress
);

Parâmetros

[in] hfci

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

[in] pszSourceFile

O nome do arquivo a ser adicionado; esse valor deve incluir informações de caminho.

[in] pszFileName

O nome sob o qual armazenar o arquivo no gabinete.

[in] fExecute

Se definido como TRUE, o arquivo será executado quando extraído.

[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 as informações de progresso disponíveis para o usuário. A função deve ser declarada usando a macro FNFCISTATUS .

[in] pfnfcigoi

Ponteiro para uma função de retorno de chamada definida pelo aplicativo para abrir um arquivo e recuperar a data, a hora e os atributos do arquivo. A função deve ser declarada usando a macro FNFCIGETOPENINFO .

[in] typeCompress

O tipo de compactação a ser usado.

Nota Para indicar a compactação LZX, use a macro TCOMPfromLZXWindow .

 

Valor	Significado
tcompTYPE_NONE 0x0000	Sem compactação.
tcompTYPE_MSZIP 0x0001	Compactação zip da Microsoft.

Valor retornado

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 de FCI.

Comentários

Quando definido, o atributo _A_EXEC é adicionado à entrada de arquivo no CAB. Esse mecanismo é usado em alguns executáveis de extração automática da Microsoft e pode ser usado para essa finalidade em qualquer aplicativo de extração personalizado.

Requisitos

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

Confira também

FCICriar