msi.h) (MsiGetComponentPathA 函数

  • 项目

MsiGetComponentPath 函数返回已安装组件的完整路径。 如果组件的项路径是注册表项，则返回注册表项。

语法

INSTALLSTATE MsiGetComponentPathA(
  [in]      LPCSTR  szProduct,
  [in]      LPCSTR  szComponent,
  [out]     LPSTR   lpPathBuf,
  [in, out] LPDWORD pcchBuf
);

parameters

[in] szProduct

指定客户端产品的产品代码。

[in] szComponent

指定要定位的组件的组件 ID。

[out] lpPathBuf

指向接收组件路径的变量的指针。 此参数可以为 null。 如果组件是一个注册表项，则注册表根目录以数字表示。 如果这是注册表子项路径，则键路径的末尾有一个反斜杠。 如果这是注册表项路径，则末尾没有反斜杠。 例如， HKEY_CURRENT_USER\SOFTWARE\Microsoft 的 32 位操作系统上的注册表路径返回为“01：\SOFTWARE\Microsoft”。 在 32 位操作系统上返回的注册表根的定义如下表所示。

注意 在 64 位操作系统上，值 20 将添加到此表中的数字注册表根，以将它们与 32 位操作系统上的注册表项路径区分开来。 例如，如果组件路径是 64 位操作系统上的注册表项，则 HKEY_CURRENT_USER\SOFTWARE\Microsoft 的注册表项路径返回为“21：\SOFTWARE\Microsoft”。
 
Root 含义
HKEY_CLASSES_ROOT
 00
HKEY_CURRENT_USER
 01
HKEY_LOCAL_MACHINE
02
HKEY_USERS
 03

[in, out] pcchBuf

指向变量的指针，该变量指定 lpPathBuf 参数指向的缓冲区的大小（以字符为单位）。 输入时，这是缓冲区的完整大小，包括终止 null 字符的空格。 如果传入的缓冲区太小，则返回的计数不包括终止 null 字符。

如果 lpPathBuf 为 null， 则 pcchBuf 可以为 null。

返回值

MsiGetComponentPath 函数返回以下值。

值 含义
INSTALLSTATE_NOTUSED
 正在请求的组件在计算机上处于禁用状态。
INSTALLSTATE_ABSENT
 未安装组件。
INSTALLSTATE_INVALIDARG
 其中一个函数参数无效。
INSTALLSTATE_LOCAL
 组件在本地安装。
INSTALLSTATE_SOURCE
 安装 组件以从源运行。
INSTALLSTATE_SOURCEABSENT
 组件源不可访问。
INSTALLSTATE_UNKNOWN
 产品代码或组件 ID 未知。

注解

MsiGetComponentPath 函数成功后，pcchBuf 参数包含 lpPathBuf 中字符串的长度。

MsiGetComponentPath 函数可能会返回INSTALLSTATE_ABSENT或INSTALL_STATE_UNKNOWN，原因如下：

  • INSTALLSTATE_ABSENT

    应用程序未正确确保通过调用 MsiUseFeature 和 MsiConfigureFeature（如有必要）安装了该功能。

  • INSTALLSTATE_UNKNOWN

    此功能未发布。 应用程序之前应该通过调用 MsiQueryFeatureState 或 MsiEnumFeatures 来确定这一点。 应用程序在初始化时进行这些调用。 应用程序应仅使用已知已发布的功能。 由于INSTALLSTATE_UNKNOWN应该也由 MsiUseFeature 返回，因此未调用 MsiUseFeature ，或者未正确检查其返回值。

注意

msi.h 标头将 MsiGetComponentPath 定义为别名，该别名根据 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 Installer 版本所需的最低 Windows Service Pack，请参阅 Windows Installer 运行时要求。
目标平台 Windows
标头 msi.h
Library Msi.lib
DLL Msi.dll

另请参阅

特定于组件的函数