Função MsiApplyMultiplePatchesA (msi.h)

Artigo
11/20/2024

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 arquivos de patch 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 ProductCode GUID 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 de 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 definindo valores de propriedade pública na linha de comando.

Observação 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 de retorno

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 elegíveis 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.

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Installer 5.0 no Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou Windows Vista. Consulte os Requisitos de Run-Time do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer.
da Plataforma de Destino	Windows
cabeçalho	msi.h
biblioteca	Msi.lib
de DLL	Msi.dll