Função MsiSourceListClearAllW (msi.h)

A função MsiSourceListClearAll remove todas as fontes de rede da lista de origem de um patch ou produto em um contexto especificado. Para obter mais informações, consulte Resiliência de origem.

Sintaxe

UINT MsiSourceListClearAllW(
  [in] LPCWSTR szProduct,
  [in] LPCWSTR 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 retornado

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

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 .

Se uma fonte de rede for a fonte atual do produto, essa função forçará o instalador a pesquisar uma fonte válida na próxima vez que uma fonte for necessária. Se a origem atual for mídia ou uma fonte de URL, ela ainda será válida após essa chamada e a lista de origem não será pesquisada, a menos que MsiSourceListForceResolution também seja chamada.

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

MsiSourceListForceResolution

ProductCode

Resiliência de origem