Função MsiSourceListSetInfoA (msi.h)
A função MsiSourceListSetInfo define informações sobre a lista de origem de um produto ou patch em um contexto específico.
Sintaxe
UINT MsiSourceListSetInfoA(
[in] LPCSTR szProductCodeOrPatchCode,
[in, optional] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions,
[in] LPCSTR szProperty,
[in] LPCSTR szValue
);
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
Esse parâmetro pode ser 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
Esse parâmetro especifica o contexto da instância do produto ou patch. Esse parâmetro pode conter um dos valores a seguir.
[in] dwOptions
O valor
Se a propriedade que está sendo definida for "LastUsedSource", esse parâmetro também especifica o tipo de origem como rede ou URL. Nesse caso, o parâmetro
[in] szProperty
O parâmetro szProperty indica o valor da propriedade a ser definido. Nem todas as propriedades que podem ser recuperadas por meio MsiSourceListGetInfo podem ser definidas por meio de uma chamada para MsiSourceListSetInfo. O szProperty valor pode ser um dos valores a seguir.
| Nome | Significado |
|---|---|
|
O caminho relativo à raiz da mídia de instalação. |
|
O modelo de prompt usado ao solicitar ao usuário a mídia de instalação. |
|
O local de origem usado mais recentemente para o produto. Se a origem não estiver registrada, a função chamará msiSourceListAddSourceEx para registrá-la. No registro bem-sucedido, a função define a origem como LastUsedSource. |
|
O nome do pacote do Windows Installer ou do pacote de patch na origem. |
[in] szValue
O novo valor da propriedade. Nenhuma validação do novo valor é executada. Esse valor não pode ser NULL. Pode ser uma cadeia de caracteres vazia.
Valor de retorno
A função
| Valor | Significado |
|---|---|
|
O usuário não tem a capacidade de definir a lista de origem para o produto especificado. |
|
Os dados de configuração estão corrompidos. |
|
Não foi possível acessar o serviço Windows Installer. |
|
Um parâmetro inválido foi passado para a função. |
|
A propriedade foi definida. |
|
O patch não foi encontrado. |
|
O produto não foi encontrado. |
|
A propriedade de origem não foi encontrada. |
|
Falha interna inesperada. |
Observações
Os administradores podem modificar a instalação de uma instância de patch ou produto que existe no contexto do computador ou em seu próprio contexto por usuário (gerenciado ou não gerenciado).) Eles podem modificar a instalação de uma instância de patch ou produto que existe no contexto por usuário gerenciado por usuário. Os administradores não podem modificar a instalação de outro usuário de um produto ou instância de patch que existe no contexto não gerenciado por usuário de outro usuário.
Os não administradores não podem modificar a instalação de uma instância de patch ou produto existente no contexto por usuário de outro usuário (gerenciado ou não gerenciado).) Eles podem modificar a instalação de uma instância de patch ou produto que existe em seu próprio contexto não gerenciado por usuário. Eles podem modificar a instalação de uma instância de patch ou produto no contexto do computador ou em seu próprio contexto gerenciado por usuário somente se estiverem habilitados para procurar uma fonte de patch ou produto. Os usuários podem ser habilitados para procurar fontes definindo a política. Para obter mais informações, consulte as políticas DisableBrowse, AllowLockdownBrowsee AlwaysInstallElevated.
Uma exceção à regra acima é definir "LastUsedSource" como uma das fontes registradas. Se a origem já estiver registrada, um não administrador poderá definir "LastUsedSource" para suas próprias instalações (gerenciadas ou não gerenciadas) e instalações por computador, independentemente das políticas.
Nota
O cabeçalho msi.h define MsiSourceListSetInfo 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. 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
sem suporte no Windows Installer 2.0 e anteriores