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

Статья
11/20/2024

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

Синтаксис

UINT MsiCollectUserInfoA(
  [in] LPCSTR 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".
целевая платформа	Виндоус
заголовка	msi.h
библиотеки	Msi.lib
DLL	Msi.dll

См. также

функций Application-Only

коды ошибок

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

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