Compartir a través de

UiCreatePatchPackageEx (Patchwiz.dll)

  • Artículo

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.