Função MsiSourceListAddSourceA (msi.h)

A função MsiSourceListAddSource adiciona à lista de fontes de rede válidas que contêm o tipo especificado de fontes para um produto ou patch em um contexto de usuário especificado.

O número de fontes na propriedade SOURCELIST é ilimitado.

Sintaxe

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

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. No Windows 2000 ou Windows XP, o nome de usuário sempre deve estar 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.

[in] szSource

Ponteiro para a cadeia de caracteres que especifica a origem.

Valor retornado

Comentários

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

Observe que essa função simplesmente adiciona a nova fonte à lista de fontes válidas. Se outra fonte tiver sido usada para instalar o produto, a nova fonte não será usada até que a fonte atual não esteja disponível.

É responsabilidade do chamador garantir que a fonte fornecida seja uma imagem de origem válida para o produto.

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 somente no estado 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 especificará 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 que o produto seja 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 seja instalado por computador.

Requisitos

Confira também

AllowLockdownBrowse

AlwaysInstallElevated

DisableBrowse

Contexto de instalação

LookupAccountName

ProductCode

SOURCELIST

Resiliência de origem