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

Статья
11/20/2024

Функция MsiGetUserInfo возвращает зарегистрированные сведения о пользователе для установленного продукта.

Синтаксис

USERINFOSTATE MsiGetUserInfoW(
  [in]      LPCWSTR szProduct,
  [out]     LPWSTR  lpUserNameBuf,
  [in, out] LPDWORD pcchUserNameBuf,
  [out]     LPWSTR  lpOrgNameBuf,
  [in, out] LPDWORD pcchOrgNameBuf,
  [in]      LPWSTR  lpSerialBuf,
  [in, out] LPDWORD pcchSerialBuf
);

Параметры

[in] szProduct

Указывает код продукта для запроса продукта.

[out] lpUserNameBuf

Указатель на переменную, которая получает имя пользователя.

[in, out] pcchUserNameBuf

Указатель на переменную, указывающую размер буфера в символах, на который указывает параметр lpUserNameBuf. Этот размер должен содержать завершающийся пустой символ.

[out] lpOrgNameBuf

Указатель на буфер, получающий имя организации.

[in, out] pcchOrgNameBuf

Указатель на переменную, указывающую размер буфера, на который указывает параметр lpOrgNameBuf. В входных данных это полный размер буфера, включая пробел для конца символа NULL. Если буфер, переданный слишком маленьким, возвращаемое число не включает завершающий символ NULL.

[in] lpSerialBuf

Указатель на буфер, который получает идентификатор продукта.

[in, out] pcchSerialBuf

Указатель на переменную, указывающую размер буфера в символах, на который указывает параметр lpSerialBuf. В входных данных это полный размер буфера, включая пробел для конца символа NULL. Если буфер, переданный слишком маленьким, возвращаемое число не включает завершающий символ NULL.

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

Ценность	Значение
USERINFOSTATE_ABSENT	Некоторые или все сведения о пользователе отсутствуют.
USERINFOSTATE_INVALIDARG	Один из параметров функции недопустим.
USERINFOSTATE_MOREDATA	Буфер слишком мал для хранения запрошенных данных.
USERINFOSTATE_PRESENT	Функция успешно завершена.
USERINFOSTATE_UNKNOWN	Код продукта не определяет известный продукт.

Замечания

Когда функция msiGetUserInfo возвращается, параметр pcchNameBuf содержит длину строки класса, хранящейся в буфере. Возвращаемое число не включает завершающийся символ NULL. Если буфер недостаточно велик, функция msiGetUserInfo возвращает USERINFOSTATE_MOREDATA, а MsiGetUserInfo содержит размер строки в символах без подсчета null символов.

Сведения о пользователе считаются присутствующих даже в отсутствие имени компании.

Заметка

Заголовок msi.h определяет MsiGetUserInfo в качестве псевдонима, который автоматически выбирает версию 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

См. также

функции состояния системы

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