Função MsiUseFeatureExA (msi.h)

Artigo
11/20/2024

A função MsiUseFeatureEx incrementa a contagem de uso de um recurso específico e indica o estado de instalação desse recurso. Essa função deve ser usada para indicar a intenção de um aplicativo de usar um recurso.

Sintaxe

INSTALLSTATE MsiUseFeatureExA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szFeature,
  [in] DWORD  dwInstallMode,
  [in] DWORD  dwReserved
);

Parâmetros

[in] szProduct

Especifica o código do produto para o produto que possui o recurso a ser usado.

[in] szFeature

Identifica o recurso a ser usado.

[in] dwInstallMode

Esse parâmetro pode ter o valor a seguir.

Valor	Significado
INSTALLMODE_NODETECTION	O valor retornado indica o estado de instalação.

[in] dwReserved

Reservado para uso futuro. Esse valor deve ser definido como 0.

Valor de retorno

Valor	Significado
INSTALLSTATE_ABSENT	O recurso não está instalado.
INSTALLSTATE_ADVERTISED	O recurso é anunciado
INSTALLSTATE_LOCAL	O recurso está instalado localmente e disponível para uso.
INSTALLSTATE_SOURCE	O recurso é instalado na origem e está disponível para uso.
INSTALLSTATE_UNKNOWN	O recurso não foi publicado.

Observações

A função MsiUseFeatureEx só deve ser usada em recursos conhecidos por serem publicados. INSTALLSTATE_UNKNOWN indica que o programa está tentando usar um recurso que não foi publicado. O aplicativo deve determinar se o recurso é publicado antes de chamar MsiUseFeature chamando MsiQueryFeatureState ou MsiEnumFeatures. O aplicativo deve fazer essas chamadas enquanto inicializa. Um aplicativo só deve usar recursos que são conhecidos por serem publicados.

Nota

O cabeçalho msi.h define MsiUseFeatureEx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Installer 5.0 no Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou Windows Vista. Windows Installer no Windows Server 2003 ou Windows XP. Consulte os Requisitos de Run-Time do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer.
da Plataforma de Destino	Windows
cabeçalho	msi.h
biblioteca	Msi.lib
de DLL	Msi.dll

Consulte também

Funções Application-Only

Compartilhar via