Função MsiApplyMultiplePatchesA (msi.h)

Artigo
08/24/2023

A função MsiApplyMultiplePatches aplica um ou mais patches a produtos qualificados para receber os patches. A função MsiApplyMultiplePatches define a propriedade PATCH com uma lista de patches delimitados por ponto-e-vírgula e invoca a aplicação de patch dos produtos de destino. Outras propriedades podem ser definidas usando uma lista de propriedades.

Sintaxe

UINT MsiApplyMultiplePatchesA(
  [in]           LPCSTR szPatchPackages,
  [in, optional] LPCSTR szProductCode,
  [in, optional] LPCSTR szPropertiesList
);

Parâmetros

[in] szPatchPackages

Uma lista delimitada por ponto e vírgula dos caminhos para corrigir arquivos como uma única cadeia de caracteres. Por exemplo: ""c:\sus\download\cache\Office\sp1.msp; c:\sus\download\cache\Office\QFE1.msp; c:\sus\download\cache\Office\QFEn.msp" "

[in, optional] szProductCode

Esse parâmetro é o GUID productcode do produto a ser corrigido. O usuário ou aplicativo que chama MsiApplyMultiplePatches deve ter privilégios para aplicar patches. Quando esse parâmetro é NULL, os patches são aplicados a todos os produtos qualificados. Quando esse parâmetro não é NULL, os patches são aplicados somente ao produto especificado.

[in, optional] szPropertiesList

Uma cadeia de caracteres terminada em nulo que especifica as configurações de propriedade de linha de comando usadas durante a aplicação de patch de produtos. Se não houver configurações de propriedade de linha de comando, passe um ponteiro NULL . Uma cadeia de caracteres vazia é um parâmetro inválido. Essas propriedades são compartilhadas por todos os produtos de destino. Para obter mais informações, consulte
Sobre propriedades e configuração de valores de propriedade pública na linha de comando.

Nota A lista de propriedades não deve conter a propriedade PATCH . Se a propriedade PATCH estiver definida na linha de comando, o valor será ignorado e será substituído com os patches sendo aplicados.

Valor retornado

A função MsiApplyMultiplePatches retorna os valores a seguir.

Valor	Significado
ERROR_INVALID_PARAMETER	Alguns argumentos passados são incorretos ou contraditórios.
ERROR_SUCCESS	A função foi concluída e todos os produtos foram corrigidos com êxito. ERROR_SUCCESS será retornado somente se todos os produtos qualificados para os patches forem corrigidos com êxito. Se nenhum dos novos patches for aplicável, MsiApplyMultiplePatches retornará ERROR_SUCCESS e o estado do produto permanecerá inalterado.
ERROR_SUCCESS_REBOOT_INITIATED	A reinicialização iniciada pela última transação encerrou essa chamada para MsiApplyMultiplePatches. Todos os produtos de destino podem não ter sido corrigidos.
ERROR_SUCCESS_REBOOT_REQUIRED	A reinicialização exigida pela última transação encerrou essa chamada para MsiApplyMultiplePatches. Todos os produtos de destino podem não ter sido corrigidos.
ERROR_PATCH_PACKAGE_OPEN_FAILED	Não foi possível abrir um dos pacotes de patch fornecidos.
ERROR_PATCH_PACKAGE_INVALID	Um dos pacotes de patch fornecidos não é válido.
ERROR_PATCH_PACKAGE_UNSUPPORTED	Um dos pacotes de patch não tem suporte.
Qualquer erro em Winerror.h	Implica uma possível conclusão parcial ou que uma ou mais transações falharam.

Comentários

Observação

O cabeçalho msi.h define MsiApplyMultiplePatches como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos


Cliente mínimo com suporte	Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Confira os Requisitos de tempo de execução do Windows Installer para obter informações sobre o Windows service pack mínimo exigido por uma versão do Windows Installer.
Plataforma de Destino	Windows
Cabeçalho	msi.h
Biblioteca	Msi.lib
DLL	Msi.dll