Função MsiGetPatchFileListA (msi.h)
A função MsiGetPatchFileList é fornecida uma lista de arquivos .msp, delimitados por ponto-e-vírgula e recupera a lista de arquivos que podem ser atualizados pelos patches.
Sintaxe
UINT MsiGetPatchFileListA(
[in] LPCSTR szProductCode,
[in] LPCSTR szPatchPackages,
[in, out] LPDWORD pcFiles,
[in, out] MSIHANDLE **pphFileRecords
);
Parâmetros
[in] szProductCode
Um valor de cadeia de caracteres terminada em nulo que contém o (GUID) do produto que é o destino dos patches. Esse parâmetro não pode ser NULL.
[in] szPatchPackages
Um valor de cadeia de caracteres com término nulo que contém a lista de patches do Windows Installer (arquivos .msp). Cada patch pode ser especificado pelo caminho completo para o pacote de patch. Os patches na lista são delimitados por ponto-e-vírgula. Pelo menos um patch deve ser especificado.
[in, out] pcFiles
Um ponteiro para um local que recebe o número de arquivos que serão atualizados neste sistema por esta lista de patches especificados por szPatchList. Esse parâmetro é necessário.
[in, out] pphFileRecords
Um ponteiro para um local que recebe um ponteiro para uma matriz de registros. O primeiro campo (0 índice) de cada registro contém o caminho de arquivo completo de um arquivo que pode ser atualizado quando a lista de patches em szPatchList são aplicados neste computador. Esse parâmetro é necessário.
Valor de retorno
A função MsiGetPatchFileList retorna os valores a seguir.
| Valor | Significado |
|---|---|
|
A função foi concluída com êxito. |
|
Um parâmetro inválido foi passado para a função. |
|
Falha na função. |
Observações
Por exemplo, szPatchList pode ter o valor: "c:\sus\download\cache\Office\sp1.msp; c:\sus\download\cache\Office\QFE1.msp; c:\sus\download\cache\Office\QFEn.msp".
Essa função é executada no contexto do chamador. O código do produto é pesquisado na ordem de contexto não gerenciado pelo usuário, contexto gerenciado pelo usuário e contexto do computador.
Você deve fechar todos os objetos MSIHANDLE retornados por essa função chamando a função MsiCloseHandle.
Se a função falhar, você poderá obter informações de erro estendidas usando a função MsiGetLastErrorRecord.
Para obter mais informações sobre como usar a função MsiGetPatchFileList, consulte Listando os arquivos que podem ser atualizados.
Nota
O cabeçalho msi.h define MsiGetPatchFileList 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. Windows Installer 4.5 no Windows Server 2003 e Windows XP. 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 |