Функция MsiEnumProductsW (msi.h)
Функция MsiEnumProducts перечисляет все продукты, объявленные или установленные в настоящее время. Продукты, устанавливаемые как в контексте установки для пользователя, так и для каждого компьютера, а также в объявлениях перечисляются.
Синтаксис
UINT MsiEnumProductsW(
[in] DWORD iProductIndex,
[out] LPWSTR lpProductBuf
);
Параметры
[in] iProductIndex
Указывает индекс извлекаемого продукта. Этот параметр должен быть равен нулю для первого вызова функции MsiEnumProducts , а затем увеличиваться для последующих вызовов. Поскольку продукты не заказываются, любой новый продукт имеет произвольный индекс. Это означает, что функция может возвращать продукты в любом порядке.
[out] lpProductBuf
Указатель на буфер, который получает код продукта. Этот буфер должен содержать 39 символов. Первые 38 символов предназначены для GUID, а последний — для завершающего символа NULL.
Возвращаемое значение
| Значение | Значение |
|---|---|
|
Данные конфигурации повреждены. |
|
В функцию передан недопустимый параметр. |
|
Нет продуктов для возврата. |
|
В системе недостаточно памяти для выполнения операции. Доступно в Windows Server 2003. |
|
Значение перечислено. |
Комментарии
Для перечисления продуктов приложение должно сначала вызвать функцию MsiEnumProducts с параметром iProductIndex , равным нулю. Затем приложение должно увеличить параметр iProductIndex и вызывать MsiEnumProducts , пока не будет больше продуктов (пока функция не вернет ERROR_NO_MORE_ITEMS).
При выполнении нескольких вызовов MsiEnumProducts для перечисления всех продуктов каждый вызов должен выполняться из одного потока.
Примечание
Заголовок msi.h определяет MsiEnumProducts в качестве псевдонима, который автоматически выбирает версию 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 |