Partilhar via


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.