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.

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.

Requisitos

Confira também

Contexto de instalação

Sem suporte no Windows Installer 2.0 e nas versões anteriores

ProductCode