msi.h) (MsiLocateComponentA 函数
MsiLocateComponent 函数返回已安装组件的完整路径,而不返回产品代码。 此函数尝试使用 MsiGetProductCode 确定产品,但不保证为调用方找到正确的产品。 应始终尽可能调用 MsiGetComponentPath。
语法
INSTALLSTATE MsiLocateComponentA(
[in] LPCSTR szComponent,
[out] LPSTR 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。
返回值
值 | 含义 |
---|---|
|
正在请求的组件在计算机上处于禁用状态。 |
|
未安装组件。 请参阅“备注”。 |
|
其中一个函数参数无效。 |
|
组件在本地安装。 |
|
提供的缓冲区太小。 |
|
安装 组件以从源运行。 |
|
组件源不可访问。 |
|
产品代码或组件 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 运行时要求。 |
目标平台 | Windows |
标头 | msi.h |
Library | Msi.lib |
DLL | Msi.dll |