Função MsiGetProductInfoA (msi.h)

A função MsiGetProductInfo retorna informações do produto para produtos publicados e instalados.

Sintaxe

UINT MsiGetProductInfoA(
  [in]      LPCSTR  szProduct,
  [in]      LPCSTR  szAttribute,
  [out]     LPSTR   lpValueBuf,
  [in, out] LPDWORD pcchValueBuf
);

Parâmetros

[in] szProduct

Especifica o código do produto para o produto.

[in] szAttribute

Especifica a propriedade que será recuperada.

As Propriedades Necessárias têm a garantia de estar disponíveis, mas outras propriedades só estarão disponíveis se essa propriedade estiver definida. Para obter mais informações, consulte Propriedades. As propriedades na lista a seguir só podem ser recuperadas de aplicativos instalados.

Para recuperar a ID do produto, o proprietário registrado ou a empresa registrada de aplicativos instalados, defina szProperty como um dos valores de cadeia de caracteres de texto a seguir.

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

As propriedades anunciadas na lista a seguir podem ser recuperadas de aplicativos anunciados ou instalados.

[out] lpValueBuf

Ponteiro para um buffer que recebe o valor da propriedade. Este parâmetro pode ser nulo.

[in, out] pcchValueBuf

Ponteiro para uma variável que especifica o tamanho, em caracteres, do buffer apontado pelo parâmetro lpValueBuf . Na entrada, esse é o tamanho total do buffer, incluindo um espaço para um caractere nulo de terminação. Se o buffer passado for muito pequeno, a contagem retornada não incluirá o caractere nulo de terminação.

Se lpValueBuf for nulo, pcchValueBuf poderá ser nulo. Nesse caso, a função verifica se a propriedade está registrada corretamente com o produto.

Valor retornado

Comentários

Quando a função MsiGetProductInfo retorna, o parâmetro pcchValueBuf contém o comprimento da cadeia de caracteres armazenada no buffer. A contagem retornada não inclui o caractere nulo de terminação. Se o buffer não for grande o suficiente, MsiGetProductInfo retornará ERROR_MORE_DATA e pcchValueBuf conterá o tamanho da cadeia de caracteres, em caracteres, sem contar o caractere nulo.

MsiGetProductInfo(INSTALLPROPERTY_LOCALPACKAGE) não retorna necessariamente um caminho para o pacote armazenado em cache. O pacote armazenado em cache é somente para uso interno. As instalações do modo de manutenção devem ser invocadas por meio das funções MsiConfigureFeature, MsiConfigureProduct ou MsiConfigureProductEx .

Se você tentar usar MsiGetProductInfo para consultar um produto anunciado para uma propriedade que só está disponível para produtos instalados, a função retornará ERROR_UNKNOWN_PROPERTY. Por exemplo, se o aplicativo for anunciado e não estiver instalado, uma consulta para a propriedade INSTALLPROPERTY_INSTALLLOCATION retornará um erro de ERROR_UNKNOWN_PROPERTY.

Requisitos

Confira também

Determinar o contexto de instalação

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

Funções de status do sistema