MsiCollectUserInfo

[This is preliminary documentation and subject to change.]

The MsiCollectUserInfo function obtains and stores the user information and product ID from an installation wizard.

UINT MsiCollectUserInfo(
  LPCTSTR szProduct    // product code
);
 

Parameters

szProduct

Specifies the product code of the product for which the user information is collected.

Return Values

ERROR_INVALID_PARAMETER

An invalid parameter was passed to the function.

ERROR_SUCCESS

The function succeeded.

Any Action Error

An error relating to an action occurred.

Any Initialization Error

An error relating to initialization occurred.

Remarks

The MsiCollectUserInfo function is typically called by an application during the first run of the application. The application first calls MsiGetUserInfo. If that call fails, the application calls MsiCollectUserInfo. MsiCollectUserInfo opens the product's installation package and invokes a wizard sequence that collects user information. Upon completion of the sequence, user information is registered. Since this API requires an authored user interface, the user interface level should be set to full by calling MsiSetInternalUI as INSTALLUILEVEL_FULL..

The MsiCollectUserInfo invokes a FirstRun action.

QuickInfo

  Windows NT: Requires version 4.0 or later. Available as a redistributable for Windows NT 4.0.
  Windows: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in msi.h.
  Import Library: Use msi.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Application-Only Functions