MsiCollectUserInfoA 函数 (msi.h)

  • 项目

MsiCollectUserInfo 函数从安装向导获取并存储用户信息和产品 ID。

语法

UINT MsiCollectUserInfoA(
  [in] LPCSTR szProduct
);

parameters

[in] szProduct

指定收集用户信息的产品的产品代码。

返回值

值 含义
ERROR_INVALID_PARAMETER
 向该函数传递了无效参数。
ERROR_SUCCESS
 函数成功。
与操作相关的错误
 请参阅 错误代码。
初始化错误
 发生与初始化相关的错误。
 
 

注解

在应用程序首次运行期间，应用程序通常会调用 MsiCollectUserInfo 函数。 应用程序首先调用 MsiGetUserInfo。 如果该调用失败，应用程序将调用 MsiCollectUserInfo。 MsiCollectUserInfo 将打开产品的安装包，并调用收集用户信息的向导序列。 完成序列后，将注册用户信息。 由于此 API 需要创作的用户界面，因此应通过调用 MsiSetInternalUI 作为INSTALLUILEVEL_FULL将用户界面级别设置为 full。

MsiCollectUserInfo 调用 FirstRun 对话框。

注意

msi.h 标头将 MsiCollectUserInfo 定义为别名，该别名根据 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

另请参阅

仅限应用程序的函数

错误代码

初始化错误