UiCreatePatchPackageEx (Patchwiz.dll)

A função UiCreatePatchPackageEx usa um arquivo de criação de pacote (arquivo .pcp) e gera um pacote de patch do Windows Installer (pacote .msp). Chamar Msimsp.exe é o método recomendado para usar Patchwiz.dll.

A função UiCreatePatchPackageEx está disponível a partir do Patchwiz.dll versão 4.0 e estende a funcionalidade da função UiCreatePatchPackage.

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

Parâmetros

szPcpPath

Caminho completo para o arquivo de propriedades de criação do patch (arquivo .pcp) para este patch.

szPatchPath

Caminho completo para o pacote de patch do Windows Installer (arquivo .msp) a ser criado. Este parâmetro pode ser NULL ou uma cadeia de caracteres vazia, mas não pode ser omitido. Se estiver NULL ou uma cadeia de caracteres vazia, a função usará o valor de PatchOutputPath na Tabela de Propriedades do (Patchwiz.dll).

szLogPath

Caminho completo para um arquivo de log de texto que será anexado. Este parâmetro pode ser NULL ou uma cadeia de caracteres vazia, mas não pode ser omitido.

hwndStatus

Manipule uma janela que exibe o texto de status. Este parâmetro pode ser NULL ou uma cadeia de caracteres vazia, mas não pode ser omitido.

szTempFolder

Local para arquivos temporários. Este parâmetro pode ser NULL ou uma cadeia de caracteres vazia, mas não pode ser omitido. O usuário deve ter privilégios suficientes para ler e gravar nesta pasta. O local padrão é %TMP%\~pcw_tmp.tmp\.

fRemoveTempFolderContents

Se TRUE, remova a pasta temporária e todo o seu conteúdo, se presente. Se FALSEe a pasta estiver presente, a função falhará.

dwFlags

Esse parâmetro pode ser definido como um ou uma combinação dos seguintes valores para especificar as opções de registro em log ou de interface do usuário.

Bandeira	Valor	Significado
LOGNONE	0x00000000	Não escreva mensagens no log.
LOGINFO	0x00000001	Escreva mensagens informativas no log.
LOGWARN	0x00000002	Escreva avisos no log.
LOGERR	0x00000004	Escreva mensagens de erro no log.
LOGPERFMESSAGES	0x00000008	Escreva mensagens de desempenho no log.
UINONE	0x00000000f	Não exiba a interface do usuário.
UIALL	0x00000010	Exiba a interface do usuário.

 

dwReserved

Reservado. Este parâmetro deve ser definido como zero.

Valores de retorno

Consulte a tabela em Return Values for UiCreatePatchPackage.

Comentários

Para obter um exemplo de criação de um arquivo .pcp e usando UiCreatePatchPackage para gerar um pacote de patch do Windows Installer, consulte a seção A Small Update Patching Example.

A criação de um patch requer uma imagem de configuração não comprimida, como uma imagem administrativa ou uma imagem de configuração não comprimida a partir de um CD-ROM. UiCreatePatchPackage não gera patches binários para arquivos em gabinetes.