Função MsiSourceListClearAllExA (msi.h)

A função MsiSourceListClearAllEx remove todas as fontes existentes de um determinado tipo de origem para o produto ou instância de patch especificada. O registro de patch também será removido se a única fonte do patch for removida e se o patch não estiver instalado como um novo patch por qualquer cliente no mesmo contexto. Especificar que MsiSourceListClearAllEx remova a origem atual deste produto ou patch força o instalador a pesquisar uma fonte na próxima vez que uma fonte for necessária.

Sintaxe

UINT MsiSourceListClearAllExA(
  [in]           LPCSTR            szProductCodeOrPatchCode,
  [in, optional] LPCSTR            szUserSid,
  [in]           MSIINSTALLCONTEXT dwContext,
  [in]           DWORD             dwOptions
);

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. O uso do SID do computador ("S-1-5-18") retorna ERROR_INVALID PARAMETER. Ao referenciar a conta de usuário atual, szUserSID pode ser NULL e dwContext pode ser MSIINSTALLCONTEXT_USERMANAGED ou MSIINSTALLCONTEXT_USERUNMANAGED.

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

[in] dwOptions

O valor dwOptions determina a interpretação do valor szProductCodeOrPatchCode e o tipo de fontes a serem limpas. Esse parâmetro deve ser uma combinação de uma das seguintes constantes MSISOURCETYPE_* e uma das seguintes constantes MSICODE_*.

Valor retornado

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 a procurar fontes definindo a política, para obter mais informações, consulte DisableBrowse, AllowLockdownBrowse e PolíticasAlwaysInstallElevated .

Requisitos

Confira também

AllowLockdownBrowse

AlwaysInstallElevated

DisableBrowse

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

ProductCode