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.

Requisitos

Confira também

Funções de localização do instalador