Функция MsiSourceListForceResolutionW (msi.h)
Функция MsiSourceListForceResolution заставляет установщик выполнять поиск в списке источников допустимого источника продукта в следующий раз, когда потребуется источник. Например, когда установщик выполняет установку или переустановку или когда ему требуется путь для компонента, настроенного для запуска из источника.
Синтаксис
UINT MsiSourceListForceResolutionW(
[in] LPCWSTR szProduct,
[in] LPCWSTR szUserName,
[in] DWORD dwReserved
);
Параметры
[in] szProduct
Код продукта, который требуется изменить.
[in] szUserName
Имя пользователя для установки на пользователя. Имя пользователя всегда должно быть в формате DOMAIN\USERNAME (или MACHINENAME\USERNAME для локального пользователя).
Пустая строка или ЗНАЧЕНИЕ NULL для установки на компьютере.
[in] dwReserved
Зарезервировано для последующего использования. Это значение должно быть равно 0.
Возвращаемое значение
Функция MsiSourceListForceResolution возвращает следующие значения.
| Значение | Значение |
|---|---|
|
Вызывающий объект не имеет достаточного доступа для принудительного разрешения продукта. |
|
Данные конфигурации повреждены. |
|
Указанный пользователь не является допустимым пользователем. |
|
Не удалось выполнить функцию. |
|
Не удалось получить доступ к службе установки. |
|
В функцию передан недопустимый параметр. |
|
Функция выполнена успешно. |
|
Указанный продукт неизвестен. |
Комментарии
Администратор может изменять установки на компьютере, собственные неуправляемые установки для каждого пользователя и управляемые установки для каждого пользователя для любого пользователя. Неадминистратор может изменять только установки на компьютере и собственные (управляемые или неуправляемые) установки для каждого пользователя.
Если имя пользователя является пустой строкой или значением NULL, функция работает с установкой продукта на каждом компьютере. В этом случае, если продукт устанавливается только для каждого пользователя, функция возвращает ERROR_UNKNOWN_PRODUCT.
Если имя пользователя не является пустой строкой или значением NULL, оно указывает имя пользователя, установка продукта которого изменена. Если имя пользователя является текущим, функция сначала пытается изменить неуправляемую установку продукта. Если не удается найти неуправляемую установку продукта, функция пытается изменить управляемую установку продукта на пользователя. Если управляемые или неуправляемые установки продукта не найдены, функция возвращает ERROR_UNKNOWN_PRODUCT, даже если продукт установлен на каждом компьютере.
Эта функция не может изменить неуправляемую установку для любого пользователя, кроме текущего пользователя. Если имя пользователя не является пустой строкой или значением NULL, но не является текущим пользователем, функция проверяет только управляемую установку продукта для указанного пользователя. Если продукт не устанавливается как управляемый для каждого пользователя для указанного пользователя, функция возвращает ERROR_UNKNOWN_PRODUCT, даже если продукт установлен на каждом компьютере.
Примечание
Заголовок msi.h определяет MsiSourceListForceResolution в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Установщик 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 |