MsiSetTargetPathA 函数 (msiquery.h)

  • 项目

MsiSetTargetPath 函数为目录表中的文件夹设置完整目标路径。

语法

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

参数

[in] hInstall

提供给 DLL 自定义操作或通过 MsiOpenPackage、MsiOpenPackageEx 或 MsiOpenProduct 获取的安装的句柄。

[in] szFolder

指定文件夹标识符。 这是目录表中的主键。

[in] szFolderPath

指定文件夹的完整路径，以目录分隔符结尾。

返回值

MsiSetTargetPath 函数返回以下值：

注解

MsiSetTargetPath 函数更改内存中目录表中名为 的目标目录的路径规范。 此外，表中从属或等效于已更改路径的所有其他路径对象的路径规范将更新为反映更改。 还会更新每个受影响路径的属性。

如果所选目录为只读，MsiSetTargetPath 将失败。

如果此函数中发生错误，则所有更新的路径和属性还原其以前的值。 因此，将此函数返回的错误视为非致命错误是安全的。

如果已为当前用户或其他用户安装了使用这些路径的组件，请勿尝试配置目标路径。 在调用 MsiSetTargetPath 之前，请检查 ProductState 属性，以确定是否安装了包含此组件的产品。

请参阅 从程序调用数据库函数。

如果函数失败，可以使用 MsiGetLastErrorRecord 获取扩展错误信息。

注意

msiquery.h 标头将 MsiSetTargetPath 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求 值
最低受支持的客户端 Windows Server 2012、Windows 8、Windows Server 2008 R2 或 Windows 7 上的 Windows Installer 5.0。 Windows Server 2008 或 Windows Vista 上的 Windows Installer 4.0 或 Windows Installer 4.5。 Windows Server 2003 或 Windows XP 上的 Windows Installer
目标平台 Windows
标头 msiquery.h
Library Msi.lib
DLL Msi.dll

另请参阅

安装程序位置函数