Compartilhar via


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.

Tipo de SID Significado
NULO
NULL indica o usuário conectado no momento. Ao referenciar a conta de usuário atual, szUserSID pode ser NULL e dwContext pode ser MSIINSTALLCONTEXT_USERMANAGED ou MSIINSTALLCONTEXT_USERUNMANAGED.
SID de usuário
Especifica a enumeração para um usuário específico no sistema. Um exemplo de SID de usuário é "S-1-3-64-2415071341-1358098788-3127455600-2561".
 
Nota A cadeia de caracteres sid especial "S-1-5-18" (sistema) não pode ser usada para enumerar produtos ou patches instalados como por computador. Definir o valor de SID como "S-1-5-18" retorna "ERROR_INVALID_PARAMETER".
 
Nota A cadeia de caracteres sid especial "S-1-1-0" (todos) não deve ser usada. A configuração do valor sid como "S-1-1-0" falha e retorna ERROR_INVALID_PARAM.
 

[in] dwContext

Esse parâmetro especifica o contexto da instância de produto ou patch. Esse parâmetro pode conter um dos valores a seguir.

Tipo de contexto Significado
MSIINSTALLCONTEXT_USERMANAGED
O produto ou a instância de patch existe no contexto gerenciado por usuário.
MSIINSTALLCONTEXT_USERUNMANAGED
O produto ou a instância de patch existe no contexto por usuário não gerenciado.
MSIINSTALLCONTEXT_MACHINE
O produto ou a instância de patch existe no contexto por computador.

[in] dwOptions

O valor dwOptions especifica o significado de szProductCodeOrPatchCode.

Se a propriedade que está sendo definida for "LastUsedSource", esse parâmetro também especificará o tipo de origem como rede ou URL. Nesse caso, o parâmetro dwOptions deve ser uma combinação de uma das seguintes constantes MSISOURCETYPE_ e uma das seguintes constantes MSICODE_ .

Sinalizador Significado
MSISOURCETYPE_NETWORK
A origem é um tipo de rede.
MSISOURCETYPE_URL
A origem é um tipo de URL.
MSICODE_PRODUCT
szProductCodeOrPatchCode é um GUID de código de produto.
MSICODE_PATCH
szProductCodeOrPatchCode é um GUID de código de patch.

[in] szProperty

O parâmetro szProperty indica o valor da propriedade a ser definido. Nem todas as propriedades que podem ser recuperadas por meio de MsiSourceListGetInfo podem ser definidas por meio de uma chamada para MsiSourceListSetInfo. O valor szProperty pode ser um dos valores a seguir.

Nome Significado
INSTALLPROPERTY_MEDIAPACKAGEPATH
"MediaPackagePath"
O caminho relativo à raiz da mídia de instalação.
INSTALLPROPERTY_DISKPROMPT
"DiskPrompt"
O modelo de prompt usado ao solicitar ao usuário a mídia de instalação.
INSTALLPROPERTY_LASTUSEDSOURCE
"LastUsedSource"
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.
INSTALLPROPERTY_PACKAGENAME
"PackageName"
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.

Retornar valor

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

Valor Significado
ERROR_ACCESS_DENIED
O usuário não tem a capacidade de definir a lista de origem para o produto especificado.
ERROR_BAD_CONFIGURATION
Os dados de configuração estão corrompidos.
ERROR_INSTALL_SERVICE_FAILURE
Não foi possível acessar o Serviço Windows Installer.
ERROR_INVALID_PARAMETER
Um parâmetro inválido foi passado para a função.
ERROR_SUCCESS
A propriedade foi definida.
ERROR_UNKNOWN_PATCH
O patch não foi encontrado.
ERROR_UNKNOWN_PRODUCT
O produto não foi encontrado.
ERROR_UNKNOWN_PROPERTY
A propriedade de origem não foi encontrada.
ERROR_FUNCTION_FAILED
Falha interna inesperada.

Comentários

Os administradores podem modificar a instalação de um produto ou instância de patch 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 um produto ou instância de patch 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 desse outro usuário.

Não administradores não podem modificar a instalação de um produto ou instância de patch que existe no contexto por usuário de outro usuário (gerenciado ou não gerenciado).) Eles podem modificar a instalação de um produto ou instância de patch que existe em seu próprio contexto por usuário não gerenciado. Eles podem modificar a instalação de um produto ou instância de patch no contexto do computador ou seu próprio contexto gerenciado por usuário somente se estiverem habilitados para procurar um produto ou fonte de patch. Os usuários podem ser habilitados para procurar fontes definindo a política. Para obter mais informações, consulte as políticas DisableBrowse, AllowLockdownBrowse e 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" como suas próprias instalações (gerenciadas ou não gerenciadas) e instalações por computador, independentemente das políticas.

Observação

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. 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

Requisito Valor
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. Confira os Requisitos de tempo de execução do Windows Installer para obter informações sobre o Windows service pack mínimo 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

Contexto de instalação

MsiSourceListGetInfo

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

ProductCode