Поделиться через

Функция MsiCollectUserInfoW (msi.h)

  • Статья

Функция MsiCollectUserInfo получает и сохраняет сведения о пользователе и идентификаторе продукта из мастера установки.

Синтаксис

UINT MsiCollectUserInfoW(
  [in] LPCWSTR szProduct
);

Параметры

[in] szProduct

Указывает код продукта, для которого собираются сведения о пользователе.

Возвращаемое значение

Значение Значение
ERROR_INVALID_PARAMETER
 В функцию передан недопустимый параметр.
ERROR_SUCCESS
 Функция выполнена успешно.
Ошибка, связанная с действием
 См . коды ошибок.
Ошибка инициализации
 Произошла ошибка, связанная с инициализацией.
 
 

Комментарии

Функция MsiCollectUserInfo обычно вызывается приложением во время первого запуска приложения. Приложение сначала вызывает MsiGetUserInfo. Если этот вызов завершается ошибкой, приложение вызывает MsiCollectUserInfo. MsiCollectUserInfo открывает пакет установки продукта и вызывает последовательность мастера, которая собирает сведения о пользователе. После завершения последовательности сведения о пользователе регистрируются. Так как для этого API требуется пользовательский интерфейс, уровень пользовательского интерфейса должен быть полным, вызвав MsiSetInternalUI в качестве INSTALLUILEVEL_FULL.

MsiCollectUserInfo вызывает диалоговое окно FirstRun.

Примечание

Заголовок msi.h определяет MsiCollectUserInfo в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Установщик Windows 5.0 в Windows Server 2012, Windows 8, Windows Server 2008 R2 или Windows 7. Установщик Windows 4.0 или установщик Windows 4.5 в Windows Server 2008 или Windows Vista. Установщик Windows в Windows Server 2003 или Windows XP. Сведения о минимальном пакете обновления Windows, необходимом для версии установщика Windows, см. в разделе Требования к установщику Windows Run-Time.
Целевая платформа Windows
Header msi.h
Библиотека Msi.lib
DLL Msi.dll

См. также раздел

Функции только для приложений

Код ошибки

Ошибка инициализации