Función FCIAddFile (fci.h)

FCIAddFile agrega un archivo al gabinete en construcción.

Sintaxis

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

Identificador de contexto de FCI válido devuelto por la función FCICreate .

[in] pszSourceFile

Nombre del archivo que se va a agregar; este valor debe incluir información de ruta de acceso.

[in] pszFileName

Nombre bajo el que se va a almacenar el archivo en el gabinete.

[in] fExecute

Si se establece TRUE, el archivo se ejecutará cuando se extraiga.

[in] pfnfcignc

Puntero a una función de devolución de llamada definida por la aplicación para obtener especificaciones en el siguiente gabinete que se va a crear. La función debe declararse mediante la macro FNFCIGETNEXTCABINET .

[in] pfnfcis

Puntero a una función de devolución de llamada definida por la aplicación para actualizar la información de progreso disponible para el usuario. La función debe declararse mediante la macro FNFCISTATUS .

[in] pfnfcigoi

Puntero a una función de devolución de llamada definida por la aplicación para abrir un archivo y recuperar la fecha, hora y atributos del archivo. La función debe declararse con la macro FNFCIGETOPENINFO .

[in] typeCompress

Tipo de compresión que se va a usar.

Nota Para indicar la compresión LZX, use la macro TCOMPfromLZXWindow .

 

Valor	Significado
tcompTYPE_NONE 0x0000	Sin compresión.
tcompTYPE_MSZIP 0x0001	Compresión ZIP de Microsoft.

Valor devuelto

Si la función se ejecuta correctamente, devuelve TRUE; de lo contrario, FALSE.

La información de error extendida se proporciona en la estructura ERF utilizada para crear el contexto de FCI.

Comentarios

Cuando se establece, el atributo _A_EXEC se agrega a la entrada de archivo en el CAB. Este mecanismo se usa en algunos archivos ejecutables autoextraíble de Microsoft y se puede usar para este propósito en cualquier aplicación de extracción personalizada.

Requisitos

Plataforma de destino	Windows
Encabezado	fci.h
Library	Cabinet.lib
Archivo DLL	Cabinet.dll

Consulte también

FCICreate