Método Product.InstallProperty

A propriedade InstallProperty é o valor da propriedade para a instância deste produto.

Essa propriedade chama a função MsiGetProductInfoEx, com ProductCode, UserSid e Context do objeto Product e a propriedade solicitada como um parâmetro.

Sintaxe

Product.InstallProperty(
  property
)

Parâmetros

property

Especifica a propriedade que será recuperada. As propriedades na lista a seguir só podem ser recuperadas de aplicativos que já estão instalados. Observe que as propriedades necessárias têm a garantia de estar disponíveis, mas outras propriedades só estarão disponíveis se essa propriedade tiver sido definida. Consulte os links indicados para as propriedades do instalador para obter informações sobre como cada propriedade é definida.

Propriedades instaladas Significado
INSTALLPROPERTY_PRODUCTSTATE
Estado do produto retornado no formato de cadeia de caracteres como "1" para Anunciado e "5" para instalado.
INSTALLPROPERTY_HELPLINK
Link de suporte. Para obter mais informações, consulte a propriedade ARPHELPLINK.
INSTALLPROPERTY_HELPTELEPHONE
Telefone do suporte. Para obter mais informações, consulte a propriedade ARPHELPTELEPHONE.
INSTALLPROPERTY_INSTALLDATE
A última vez que este produto recebeu o serviço. O valor dessa propriedade é substituído sempre que um patch é aplicado ou removido do produto ou a Opção de Linha de Comando /v é usada para reparar o produto. Se o produto não tiver recebido reparos ou patches, essa propriedade conterá a hora em que ele foi instalado neste computador.
INSTALLPROPERTY_INSTALLEDPRODUCTNAME
Nome do produto instalado. Para obter mais informações, consulte a propriedade ProductName.
INSTALLPROPERTY_INSTALLLOCATION
Local de instalação. Para obter mais informações, consulte a propriedade ARPINSTALLLOCATION.
INSTALLPROPERTY_INSTALLSOURCE
Origem da Instalação. Para obter mais informações, consulte a propriedade SourceDir.
INSTALLPROPERTY_LOCALPACKAGE
Pacote armazenado em cache local.
INSTALLPROPERTY_PUBLISHER
Editor. Para obter mais informações, consulte a propriedade Manufacturer.
INSTALLPROPERTY_URLINFOABOUT
Informações da URL. Para obter mais informações, consulte a propriedade ARPURLINFOABOUT.
INSTALLPROPERTY_URLUPDATEINFO
Informações de atualização da URL. Para obter mais informações, consulte a propriedade ARPURLUPDATEINFO.
INSTALLPROPERTY_VERSIONMINOR
Versão secundária do produto derivada da propriedade ProductVersion.
INSTALLPROPERTY_VERSIONMAJOR
Versão principal do produto derivada da propriedade ProductVersion.
INSTALLPROPERTY_VERSIONSTRING
Versão do produto. Para obter mais informações, consulte a propriedade ProductVersion.

 

Para recuperar a ID do produto, o proprietário registrado ou a empresa registrada de aplicativos que já estão instalados, defina a property como um dos valores de cadeia de texto a seguir.

Valor Descrição
ProductID O identificador do produto. Para obter mais informações, consulte a propriedade ProductID.
RegCompany A empresa registrada para usar este produto.
RegOwner O proprietário registrado para usar este produto.

 

Para recuperar o tipo de instância do produto, defina property como o valor a seguir. Essa propriedade está disponível para produtos anunciados ou instalados.

Valor Descrição
InstanceType Um valor ausente ou um valor igual a 0 indica uma instalação normal do produto. Um valor 1 indica um produto instalado usando uma transformação de várias instâncias e a propriedade MSINEWINSTANCE. Disponível com o instalador executando o Windows Server 2003 ou Windows XP com SP1. Para obter mais informações, consulte Instalando várias instâncias de produtos e patches.

 

As propriedades na lista a seguir também podem ser recuperadas de aplicativos que estão anunciados. Essas propriedades não podem ser recuperadas para instâncias de produto instaladas em um contexto por usuário não gerenciado de contas de usuário diferentes da conta de usuário atual.

Propriedades anunciadas Descrição
INSTALLPROPERTY_TRANSFORMS Transformações.
INSTALLPROPERTY_LANGUAGE Idioma do produto.
INSTALLPROPERTY_PRODUCTNAME Nome de produto legível. Para obter mais informações, consulte a propriedade ProductName.
INSTALLPROPERTY_ASSIGNMENTTYPE É igual a zero (0) se o produto for anunciado ou instalado por usuário. É igual a um (1) se o produto for anunciado ou instalado por computador para todos os usuários.
INSTALLPROPERTY_PACKAGECODE Identificador do pacote do qual este produto foi instalado. Para obter detalhes, consulte Códigos de pacote.
INSTALLPROPERTY_VERSION Versão do produto derivada da propriedade ProductVersion.
INSTALLPROPERTY_PRODUCTICON Ícone principal do pacote. Para obter mais informações, consulte a propriedade ARPPRODUCTICON.
INSTALLPROPERTY_PACKAGENAME Nome do pacote de instalação original.
INSTALLPROPERTY_AUTHORIZED_LUA_APP Um valor 1 indica um produto que pode ser atendido por não administradores usando a Aplicação de patch de UAC (Controle de Conta de Usuário). Um valor ausente ou um valor igual a 0 indica que a aplicação de patch de privilégios mínimos não está habilitada. Disponível no Windows Installer 3.0 e posterior.

 

Valor retornado

Esse método não retorna um valor.

Comentários

Se a chamada for bem-sucedida, a propriedade conterá o valor como uma cadeia de caracteres.

Requisitos

Requisito Valor
Versão
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. Windows Installer 3.0 ou versões posteriores no Windows Server 2003, no Windows XP e no Windows 2000
DLL
Msi.dll
IID
O IID_IProduct é definido como 000C10A0-0000-0000-C000-000000000046

Confira também

Produto

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