Função MsiExtractPatchXMLDataW (msi.h)
A função MsiExtractPatchXMLData extrai informações de um patch que pode ser usado para determinar se o patch se aplica a um sistema de destino. A função retorna uma cadeia de caracteres XML que pode ser fornecida a MsiDeterminePatchSequence e MsiDetermineApplicablePatches em vez do arquivo de patch completo. As informações retornadas podem ser usadas para determinar se o patch é aplicável.
Sintaxe
UINT MsiExtractPatchXMLDataW(
[in] LPCWSTR szPatchPath,
[in] DWORD dwReserved,
[out, optional] LPWSTR szXMLData,
[in, out, optional] LPDWORD pcchXMLData
);
Parâmetros
[in] szPatchPath
O caminho completo para o patch que está sendo consultado. Passe como uma cadeia de caracteres terminada em nulo. Esse parâmetro não pode ser NULL.
[in] dwReserved
Um argumento reservado que deve ser 0 (zero).
[out, optional] szXMLData
Um ponteiro para um buffer para manter a cadeia de caracteres XML que contém as informações de patch extraídas. Esse buffer deve ser grande o suficiente para conter as informações recebidas. Se o buffer for muito pequeno, a função retornará ERROR_MORE_DATA e definirá *pcchXMLData como o número de TCHAR no valor, sem incluir o caractere NULL de terminação.
Se szXMLData for definido como NULL e pcchXMLData for definido como um ponteiro válido, a função retornará ERROR_SUCCESS e definirá *pcchXMLData como o número de TCHAR no valor, sem incluir o caractere NULL de terminação. Em seguida, a função pode ser chamada novamente para recuperar o valor, com o buffer szXMLData grande o suficiente para conter *pcchXMLData + 1 caracteres.
[in, out, optional] pcchXMLData
Um ponteiro para uma variável que especifica o número de TCHAR no buffer szXMLData . Quando a função retorna, esse parâmetro é definido como o tamanho do valor solicitado, quer a função copie ou não o valor para o buffer especificado. O tamanho é retornado como o número de TCHAR no valor solicitado, não incluindo o caractere nulo de terminação.
Se esse parâmetro for definido como NULL, a função retornará ERROR_INVALID_PARAMETER.
Valor retornado
A função MsiExtractPatchXMLData pode retornar os valores a seguir.
| Código de retorno | Descrição |
|---|---|
|
A função falhou de uma forma que não é identificada por nenhum dos valores retornados nesta tabela. |
|
Um parâmetro inválido foi passado para a função. |
|
O valor não se encaixa no buffer fornecido. |
|
Não foi possível abrir o arquivo de patch. |
|
A função foi bem-sucedida. |
|
Não foi possível abrir o arquivo de patch. |
|
Esse erro poderá ser retornado se o MSXML 3.0 não estiver instalado. |
Comentários
O método ExtractPatchXMLData do objeto Installer usa a função MsiExtractPatchXMLData .
Observação
O cabeçalho msi.h define MsiExtractPatchXMLData 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 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer 3.0 ou versões posteriores no Windows Server 2003 ou no Windows XP. Confira os Requisitos de tempo de execução do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer. |
| Plataforma de Destino | Windows |
| Cabeçalho | msi.h |
| Biblioteca | Msi.lib |
| DLL | Msi.dll |
Confira também
Sem suporte no Windows Installer 2.0 e nas versões anteriores