Função MsiSourceListForceResolutionA (msi.h)

Artigo
11/20/2024

A função MsiSourceListForceResolution força o instalador a pesquisar na lista de origem uma fonte de produto válida na próxima vez que uma fonte for necessária. Por exemplo, quando o instalador executa uma instalação ou reinstalação, ou quando requer o caminho para um componente que está definido para ser executado da origem.

Sintaxe

UINT MsiSourceListForceResolutionA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szUserName,
  [in] DWORD  dwReserved
);

Parâmetros

[in] szProduct

O ProductCode do produto a ser modificado.

[in] szUserName

O nome de usuário para uma instalação por usuário. O nome de usuário deve estar sempre no formato DOMAIN\USERNAME (ou MACHINENAME\USERNAME para um usuário local).

Uma cadeia de caracteres vazia ou NULL para uma instalação por computador.

[in] dwReserved

Reservado para uso futuro. Esse valor deve ser definido como 0.

Valor de retorno

A função msiSourceListForceResolution retorna os valores a seguir.

Valor	Significado
ERROR_ACCESS_DENIED	O chamador não tem acesso suficiente para forçar a resolução do produto.
ERROR_BAD_CONFIGURATION	Os dados de configuração estão corrompidos.
ERROR_BAD_USER_NAME	O usuário especificado não é um usuário válido.
ERROR_FUNCTION_FAILED	A função não pôde ser concluída.
ERROR_INSTALL_SERVICE_FAILURE	Não foi possível acessar o serviço de instalação.
ERROR_INVALID_PARAMETER	Um parâmetro inválido foi passado para a função.
ERROR_SUCCESS	A função foi bem-sucedida.
ERROR_UNKNOWN_PRODUCT	O produto especificado é desconhecido.

Observações

Um administrador pode modificar instalações por computador, suas próprias instalações não gerenciadas por usuário e as instalações gerenciadas por usuário para qualquer usuário. Um não administrador só pode modificar instalações por computador e suas próprias instalações por usuário (gerenciadas ou não gerenciadas).

Se o nome de usuário for uma cadeia de caracteres vazia ou NULL, a função funcionará na instalação por computador do produto. Nesse caso, se o produto estiver instalado apenas como por usuário, a função retornará ERROR_UNKNOWN_PRODUCT.

Se o nome de usuário não for uma cadeia de caracteres vazia ou NULL, ele especifica o nome do usuário cuja instalação do produto é modificada. Se o nome de usuário for o nome de usuário atual, a função primeiro tentará modificar uma instalação não gerenciada do produto. Se nenhuma instalação não gerenciada do produto puder ser encontrada, a função tentará modificar uma instalação gerenciada por usuário do produto. Se nenhuma instalação gerenciada ou não gerenciada por usuário do produto puder ser encontrada, a função retornará ERROR_UNKNOWN_PRODUCT, mesmo se o produto estiver instalado por computador.

Essa função não pode modificar uma instalação não gerenciada para qualquer usuário além do usuário atual. Se o nome de usuário não for uma cadeia de caracteres vazia ou NULL, mas não for o usuário atual, a função verificará apenas uma instalação gerenciada por usuário do produto para o usuário especificado. Se o produto não estiver instalado como gerenciado por usuário para o usuário especificado, a função retornará ERROR_UNKNOWN_PRODUCT, mesmo que o produto esteja instalado por computador.

Nota

O cabeçalho msi.h define MsiSourceListForceResolution 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. 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 no Windows Server 2003 ou 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

Consulte também

de contexto de instalação

LookupAccountName

MsiGetComponentPath

de resiliência de origem

Compartilhar via