Función MsiGetPatchFileListA (msi.h)

La función MsiGetPatchFileList se proporciona una lista de archivos .msp, delimitados por punto y coma y recupera la lista de archivos que las revisiones pueden actualizar.

Sintaxis

UINT MsiGetPatchFileListA(
  [in]      LPCSTR    szProductCode,
  [in]      LPCSTR    szPatchPackages,
  [in, out] LPDWORD   pcFiles,
  [in, out] MSIHANDLE **pphFileRecords
);

Parámetros

[in] szProductCode

Valor de cadena terminada en null que contiene productCode (GUID) del producto que es el destino de las revisiones. Este parámetro no puede ser NULL.

[in] szPatchPackages

Valor de cadena terminada en null que contiene la lista de revisiones de Windows Installer (archivos .msp). Cada revisión se puede especificar mediante la ruta de acceso completa al paquete de revisión. Las revisiones de la lista están delimitadas por punto y coma. Se debe especificar al menos una revisión.

[in, out] pcFiles

Puntero a una ubicación que recibe el número de archivos que se actualizarán en este sistema mediante esta lista de revisiones especificadas por szPatchList. Este parámetro es obligatorio.

[in, out] pphFileRecords

Puntero a una ubicación que recibe un puntero a una matriz de registros. El primer campo (0-index) de cada registro contiene la ruta de acceso completa de un archivo que se puede actualizar cuando se aplica la lista de revisiones en szPatchList en este equipo. Este parámetro es obligatorio.

Valor devuelto

La función MsiGetPatchFileList devuelve los siguientes valores.

Valor	Significado
ERROR_SUCCESS	Si se devuelve este valor, significa que la función se completó correctamente.
ERROR_INVALID_PARAMETER	Se pasó un parámetro no válido a la función.
ERROR_FUNCTION_FAILED	Error en la función.

Comentarios

Por ejemplo, szPatchList podría tener el valor "c:\sus\download\cache\Office\sp1.msp; c:\sus\download\cache\Office\QFE1.msp; c:\sus\download\cache\Office\QFEn.msp".

Esta función se ejecuta en el contexto del autor de la llamada. El código del producto se busca en el orden del contexto no administrado por el usuario, el contexto administrado por el usuario y el contexto de la máquina.

Debe cerrar todos los objetos MSIHANDLE devueltos por esta función llamando a la función MsiCloseHandle .

Si se produce un error en la función, puede obtener información de error extendida mediante la función MsiGetLastErrorRecord .

Para obtener más información sobre el uso de la función MsiGetPatchFileList , vea Enumerar los archivos que se pueden actualizar.

Nota

El encabezado msi.h define MsiGetPatchFileList como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Cliente mínimo compatible	Windows Installer 5.0 en Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 en Windows Server 2008 o Windows Vista. Windows Installer 4.5 en Windows Server 2003 y Windows XP. Consulte Windows Installer para obtener información sobre el Service Pack mínimo de Windows que requiere una versión de Windows Installer.
Plataforma de destino	Windows
Encabezado	msi.h
Library	Msi.lib
Archivo DLL	Msi.dll

Consulte también

No se admite en Windows Installer 3.1 ni en versiones anteriores.