Função MsiSetTargetPathA (msiquery.h)

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

Sintaxe

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

Parâmetros

[in] hInstall

Manipule para a instalação fornecida a uma ação personalizada de DLL ou obtida por meio de MsiOpenPackage, MsiOpenPackageEx ou 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.

Retornar valor

A função MsiSetTargetPath retorna os seguintes valores:

Comentários

A função MsiSetTargetPath altera a especificação de caminho para o diretório de destino chamado na tabela Diretório na memória. Além disso, as especificações de caminho de todos os outros objetos de caminho na tabela 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 reverter aos valores anteriores. Portanto, é seguro tratar os erros retornados por essa função como não-fatal.

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.

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	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 no Windows Server 2003 ou no Windows XP
Plataforma de Destino	Windows
Cabeçalho	msiquery.h
Biblioteca	Msi.lib
DLL	Msi.dll

Confira também

Funções de localização do instalador