UiCreatePatchPackageEx (Patchwiz.dll)

La función UiCreatePatchPackageEx toma un archivo de creación de paquetes (archivo .pcp) y genera un paquete de revisión de Windows Installer (paquete .msp). El método recomendado para usar Patchwiz.dll consiste en llamar a Msimsp.exe.

La función UiCreatePatchPackageEx está disponible a partir de la versión 4.0 de Patchwiz.dll y amplía la funcionalidad de la función UiCreatePatchPackage.

UINT UiCreatePatchPackageEx(
  LPCTSTR szPcpPath,              
  LPCTSTR szPatchPath,            
  LPCTSTR szLogPath,             
  HWND hwndStatus,                
  LPCTSTR szTempFolder,           
  BOOL fRemoveTempFolderContents,
  DWORD dwFlags,
  DWORD dwReserved    
);

Parámetros

szPcpPath

Ruta de acceso completa al archivo de propiedades de creación de revisiones (archivo .pcp) para esta revisión.

szPatchPath

Ruta de acceso completa al paquete de revisión de Windows Installer (archivo .msp) que se va a crear. Este parámetro puede ser NULL o una cadena vacía, pero no se puede omitir. Si es NULL o una cadena vacía, la función usa el valor de PatchOutputPath en la tabla Properties (Patchwiz.dll).

szLogPath

Ruta de acceso completa a un archivo de registro de texto que se va a anexar. Este parámetro puede ser NULL o una cadena vacía, pero no se puede omitir.

hwndStatus

Identificador de una ventana en el que se muestra el texto de estado. Este parámetro puede ser NULL o una cadena vacía, pero no se puede omitir.

szTempFolder

Ubicación de los archivos temporales. Este parámetro puede ser NULL o una cadena vacía, pero no se puede omitir. El usuario debe tener privilegios suficientes para leer y escribir en esta carpeta. La ubicación predeterminada es %TMP%\~pcw_tmp.tmp\.

fRemoveTempFolderContents

Si es TRUE, quite la carpeta temporal y todo su contenido, si está presente. Si es FALSE y la carpeta está presente, se produce un error en la función.

dwFlags

Este parámetro se puede establecer en uno de los valores siguientes, o en una combinación de estos, para especificar las opciones de interfaz de usuario o de registro.

Marca	Value	Significado
LOGNONE	0x00000000	No escriba ningún mensaje en el registro.
LOGINFO	0x00000001	Escriba mensajes informativos en el registro.
LOGWARN	0x00000002	Escriba advertencias en el registro.
LOGERR	0x00000004	Escriba mensajes de error en el registro.
LOGPERFMESSAGES	0x00000008	Escriba mensajes de rendimiento en el registro.
UINONE	0x00000000f	No muestre la interfaz de usuario.
UIALL	0x00000010	Muestre la interfaz de usuario.

 

dwReserved

Reservado. Este parámetro debe establecerse en cero.

Valores devueltos

Consulte la tabla en Valores devueltos para UiCreatePatchPackage.

Comentarios

Para obtener un ejemplo de creación de un archivo .pcp y el uso de UiCreatePatchPackage a fin de generar un paquete de revisión de Windows Installer, vea la sección Ejemplo de aplicación de revisiones de actualización pequeña.

La creación de una revisión requiere una imagen de configuración descomprimida, como una imagen administrativa o una imagen de instalación descomprimida desde un CD-ROM. UiCreatePatchPackage no genera revisiones binarias para archivos en archivos contenedores.