Função MsiSetTargetPathA (msiquery.h)

Artigo
11/20/2024

A função MsiSetTargetPath define o caminho de destino completo para uma pasta na tabela Directory.

Sintaxe

UINT MsiSetTargetPathA(
  [in] MSIHANDLE hInstall,
  [in] LPCSTR    szFolder,
  [in] LPCSTR    szFolderPath
);

Parâmetros

[in] hInstall

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

[in] szFolder

Especifica o identificador de pasta. Essa é uma chave primária na tabela Diretório.

[in] szFolderPath

Especifica o caminho completo para a pasta, terminando em um separador de diretório.

Valor de retorno

A função msiSetTargetPath retorna os seguintes valores:

Observações

A função MsiSetTargetPath altera a especificação de caminho para o diretório de destino nomeado na tabela Directory na memória. Além disso, as especificações de caminho de todos os outros objetos de caminho na tabela que são subordinados ou equivalentes ao caminho alterado são atualizadas para refletir a alteração. As propriedades de cada caminho afetado também são atualizadas.

MsiSetTargetPath falhará se o diretório selecionado for somente leitura.

Se ocorrer um erro nessa função, todos os caminhos e propriedades atualizados serão revertidos para seus valores anteriores. Portanto, é seguro tratar os erros retornados por essa função como não fatais.

Não tente configurar o caminho de destino se os componentes que usam esses caminhos já estiverem instalados para o usuário atual ou para um usuário diferente. Verifique a propriedade ProductState antes de chamar MsiSetTargetPath para determinar se o produto que contém esse componente está instalado.

Consulte chamando funções de banco de dados de programas.

Se a função falhar, você poderá obter informações de erro estendidas usando msiGetLastErrorRecord.

Nota

O cabeçalho msiquery.h define MsiSetTargetPath 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 local do instalador

Compartilhar via