Função MsiSourceListEnumSourcesA (msi.h)
A função MsiSourceListEnumSources enumera as fontes na lista de origem de um patch ou produto especificado.
Sintaxe
UINT MsiSourceListEnumSourcesA(
[in] LPCSTR szProductCodeOrPatchCode,
[in, optional] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions,
[in] DWORD dwIndex,
[in, optional] LPSTR szSource,
[in, out, optional] LPDWORD pcchSource
);
Parâmetros
[in] szProductCodeOrPatchCode
O ProductCode ou o GUID de patch do produto ou patch. Use uma cadeia de caracteres terminada em nulo. Se a cadeia de caracteres tiver mais de 39 caracteres, a função falhará e retornará ERROR_INVALID_PARAMETER. Esse parâmetro não pode ser NULL.
[in, optional] szUserSid
Um SID de cadeia de caracteres que especifica a conta de usuário que contém o produto ou patch. O SID não é validado ou resolvido. Um SID incorreto pode retornar ERROR_UNKNOWN_PRODUCT ou ERROR_UNKNOWN_PATCH. Ao referenciar um contexto de computador, szUserSID deve ser NULL e dwContext deve ser MSIINSTALLCONTEXT_MACHINE.
[in] dwContext
O contexto do produto ou da instância de patch. Esse parâmetro pode conter um dos valores a seguir.
[in] dwOptions
O valor dwOptions determina a interpretação do valor szProductCodeOrPatchCode e o tipo de fontes a serem limpas. Esse parâmetro deve ser uma combinação de uma das seguintes constantes MSISOURCETYPE_* e uma das seguintes constantes MSICODE_*.
[in] dwIndex
O índice da origem a ser recuperada. Esse parâmetro deve ser 0 (zero) para a primeira chamada para a função MsiSourceListEnumSources e incrementado para chamadas subsequentes até que a função retorne ERROR_NO_MORE_ITEMS. O índice só deverá ser incrementado se a chamada anterior retornar ERROR_SUCCESS.
[in, optional] szSource
Um ponteiro para um buffer que recebe o caminho para a origem que está sendo enumerada. Esse buffer deve ser grande o suficiente para conter o valor recebido. Se o buffer for muito pequeno, a função retornará ERROR_MORE_DATA e definirá *pcchSource como o número de TCHAR no valor, sem incluir o caractere NULL de terminação.
Se szSource for definido como NULL e pcchSource for definido como um ponteiro válido, a função retornará ERROR_SUCCESS e definirá *pcchSource como o número de TCHAR no valor, não incluindo o caractere NULL de terminação. Em seguida, a função pode ser chamada novamente para recuperar o valor, com o buffer szSource grande o suficiente para conter *pcchSource + 1 caracteres.
Se szSource e pcchSource estiverem definidos como NULL, a função retornará ERROR_SUCCESS se o valor existir, sem recuperar o valor.
[in, out, optional] pcchSource
Um ponteiro para uma variável que especifica o número de TCHAR no buffer szSource . 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.
Esse parâmetro só poderá ser definido como NULL se szSource também for NULL, caso contrário, a função retornará ERROR_INVALID_PARAMETER.
Valor retornado
A função MsiSourceListEnumSources retorna os valores a seguir.
| Valor | Significado |
|---|---|
|
O usuário não tem a capacidade de ler a lista de origem especificada. Isso não indica se um produto ou patch foi encontrado. |
|
Os dados de configuração estão corrompidos. |
|
Um parâmetro inválido é passado para a função . |
|
O buffer fornecido não é suficiente para conter os dados solicitados. |
|
Não há mais fontes na lista especificada para enumerar. |
|
Uma fonte é enumerada com êxito. |
|
O patch especificado não está instalado no computador nos contextos especificados. |
|
O produto especificado não está instalado no computador nos contextos especificados. |
|
Falha interna inesperada. |
Comentários
Ao fazer várias chamadas para MsiSourceListEnumSources para enumerar todas as fontes para uma única instância de produto, cada chamada deve ser feita do mesmo thread.
Um administrador pode enumerar instalações gerenciadas e não gerenciadas por usuário para si mesmo, instalações por computador e instalações gerenciadas por usuário para qualquer usuário. Um administrador não pode enumerar instalações não gerenciadas por usuário para outros usuários. Os não administradores só podem enumerar suas próprias instalações não gerenciadas e gerenciadas por usuário e instalações por computador.
Observação
O cabeçalho msi.h define MsiSourceListEnumSources 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. 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
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de