通过

MsiLocateComponentW 函数 （msi.h）

  • 项目

MsiLocateComponent 函数返回安装组件的完整路径，而无需使用代码示例。 此函数尝试使用 MsiGetProductCode来确定产品，但不能保证找到调用方的正确产品。 MsiGetComponentPath 应尽可能调用。

语法

INSTALLSTATE MsiLocateComponentW(
  [in]      LPCWSTR szComponent,
  [out]     LPWSTR  lpPathBuf,
  [in, out] LPDWORD pcchBuf
);

参数

[in] szComponent

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

[out] lpPathBuf

指向接收组件路径的变量的指针。 该变量包括终止 null 字符。

[in, out] pcchBuf

指向一个变量的指针，该变量指定由 lpPathBuf 参数指向的缓冲区的大小（以字符为单位）。 在输入时，这是缓冲区的完整大小，包括终止 null 字符的空间。 MsiLocateComponent 函数成功后，pcchBuf 指向的变量包含不包括终止 null 字符的字符计数。 如果传入的缓冲区的大小太小，函数将返回INSTALLSTATE_MOREDATA。

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

返回值

价值 意义
INSTALLSTATE_NOTUSED
 正在请求的组件在计算机上处于禁用状态。
INSTALLSTATE_ABSENT
 未安装该组件。 请参阅“备注”。
INSTALLSTATE_INVALIDARG
 其中一个函数参数无效。
INSTALLSTATE_LOCAL
 组件在本地安装。
INSTALLSTATE_MOREDATA
 提供的缓冲区太小。
INSTALLSTATE_SOURCE
 安装组件以从源运行。
INSTALLSTATE_SOURCEABSENT
 组件源不可访问。
INSTALLSTATE_UNKNOWN
 产品代码或组件 ID 未知。 请参阅“备注”。

言论

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

  • INSTALLSTATE_ABSENT

    应用程序未正确确保通过调用 MsiUseFeature 安装该功能，并在必要时 MsiConfigureFeature。

  • INSTALLSTATE_UNKNOWN

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

注意

msi.h 标头将 MsiLocateComponent 定义为一个别名，该别名根据 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 Run-Time 要求。
目标平台 窗户
标头 msi.h
库 Msi.lib
DLL Msi.dll

另请参阅

Component-Specific Functions