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

Статья
11/20/2024

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

Синтаксис

UINT MsiGetFeatureUsageA(
  [in]  LPCSTR  szProduct,
  [in]  LPCSTR  szFeature,
  [out] LPDWORD pdwUseCount,
  [out] LPWORD  pwDateUsed
);

Параметры

[in] szProduct

Указывает код продукта для продукта, содержащего функцию.

[in] szFeature

Указывает код компонента для функции, для которой должны быть возвращены метрики.

[out] pdwUseCount

Указывает время использования функции.

[out] pwDateUsed

Указывает дату последнего использования функции. Дата находится в формате даты MS-DOS, как показано в следующей таблице.

Биты	Значение
0 – 4	День месяца (1-31)
5 – 8	Месяц (1 = январь, 2 = февраль и т. д.)
9 – 15	Смещение года от 1980 (добавьте 1980, чтобы получить фактический год)

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

Функция MsiGetFeatureUsage возвращает следующие значения.

Ценность	Значение
ERROR_BAD_CONFIGURATION	Данные конфигурации повреждены.
ERROR_INSTALL_FAILURE	Сведения об использовании недоступны, а продукт или компонент недопустимы.
ERROR_SUCCESS	Функция успешно завершена.

Замечания

Заметка

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

См. также

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

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