Compartilhar via


Função MsiSetPropertyA (msiquery.h)

A função MsiSetProperty define o valor de uma propriedade de instalação.

Sintaxe

UINT MsiSetPropertyA(
  [in] MSIHANDLE hInstall,
  [in] LPCSTR    szName,
  [in] LPCSTR    szValue
);

Parâmetros

[in] hInstall

Manipule a instalação fornecida para uma ação personalizada de DLL ou obtida por meio MsiOpenPackage, MsiOpenPackageExou MsiOpenProduct.

[in] szName

Especifica o nome da propriedade.

[in] szValue

Especifica o valor da propriedade.

Valor de retorno

Essa função retorna UINT.

Observações

Se a propriedade não estiver definida, ela será criada pela função MsiSetProperty. Se o valor for nulo ou uma cadeia de caracteres vazia, a propriedade será removida.

Nota

O cabeçalho msiquery.h define MsiSetProperty como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do 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
da Plataforma de Destino Windows
cabeçalho msiquery.h
biblioteca Msi.lib
de DLL Msi.dll

Consulte também

Funções de acesso de estado do instalador