Функция MsiSourceListForceResolutionExW (msi.h)
Функция MsiSourceListForceResolutionEx удаляет регистрацию свойства LastUsedSource. Эта функция не влияет на список зарегистрированных источников. Всякий раз, когда установщик требует от источника переустановки продукта или исправления, он сначала пытается использовать источник, зарегистрированный как LastUsedSource. Если это не удается или эта регистрация отсутствует, установщик выполняет поиск в других зарегистрированных источниках, пока не найдет допустимый источник или пока список источников не будет исчерпан. При очистке регистрации LastUsedSource установщик должен выполнить разрешение источника для зарегистрированных источников в следующий раз, когда потребуется источник.
Синтаксис
UINT MsiSourceListForceResolutionExW(
[in] LPCWSTR szProductCodeOrPatchCode,
[in, optional] LPCWSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions
);
Параметры
[in] szProductCodeOrPatchCode
Идентификатор GUID productcode или patch продукта или исправления. Используйте строку, завершаемую null. Если строка длиннее 39 символов, функция завершается ошибкой и возвращает ERROR_INVALID_PARAMETER. Этот параметр не может иметь значение NULL.
[in, optional] szUserSid
Этот параметр может быть строковым идентификатором безопасности, указывающим учетную запись пользователя, содержащую продукт или исправление. Идентификатор безопасности не проверяется и не разрешается. Неправильный идентификатор безопасности может возвращать ERROR_UNKNOWN_PRODUCT или ERROR_UNKNOWN_PATCH. При ссылке на контекст компьютера szUserSID должен иметь значение NULL , а dwContext — MSIINSTALLCONTEXT_MACHINE. Использование идентификатора безопасности компьютера (S-1-5-18) возвращает ERROR_INVALID PARAMETER. При ссылке на текущую учетную запись пользователя szUserSID может иметь значение NULL , а dwContext — MSIINSTALLCONTEXT_USERMANAGED или MSIINSTALLCONTEXT_USERUNMANAGED.
[in] dwContext
Этот параметр задает контекст экземпляра продукта или исправления. Этот параметр может содержать одно из следующих значений.
[in] dwOptions
Значение dwOptions определяет интерпретацию значения szProductCodeOrPatchCode .
| Flag | Значение |
|---|---|
|
szProductCodeOrPatchCode — это код продукта. |
|
szProductCodeOrPatchCode — это код исправления. |
Возвращаемое значение
Функция MsiSourceListForceResolutionEx возвращает следующие значения.
| Значение | Значение |
|---|---|
|
Пользователь не имеет возможности изменять указанный исходный список. Не указывает, был ли найден продукт или исправление. |
|
Данные конфигурации повреждены. |
|
Не удалось получить доступ к службе установщика Windows |
|
В функцию передан недопустимый параметр. |
|
Регистрация LastUsedSource была снята. |
|
Исправление не найдено. |
|
Указанный продукт или исправление не найдены. |
|
Непредвиденный внутренний сбой. |
Комментарии
Администраторы могут изменять установку продукта или экземпляра исправления, который существует в контексте компьютера или в собственном контексте для каждого пользователя (управляемом или неуправляемом). Они могут изменять установку продукта или экземпляра исправления, который существует в контексте, управляемом пользователем. Администраторы не могут изменять установку продукта или экземпляра исправления другого пользователя, который существует в неуправляемом контексте этого другого пользователя.
Пользователи, не являющиеся администраторами, не могут изменять установку продукта или экземпляра исправления, который существует в контексте для каждого пользователя другого пользователя (управляемого или неуправляемого). Они могут изменять установку продукта или экземпляра исправления, который существует в их собственном неуправляемом контексте для каждого пользователя. Они могут изменять установку продукта или экземпляра исправлений в контексте компьютера или в собственном контексте, управляемом пользователем, только если им разрешено просматривать продукт или источник исправлений. Пользователи могут иметь возможность просматривать источники, задав политику. Дополнительные сведения см. в разделах Политики DisableBrowse, AllowLockdownBrowse и AlwaysInstallElevated .
Примечание
Заголовок msi.h определяет MsiSourceListForceResolutionEx как псевдоним, который автоматически выбирает версию 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 3.0 или более поздней версии в Windows Server 2003 или Windows XP. Сведения о минимальном пакете обновления Windows, необходимом для версии установщика Windows, см. в статье Требования к установщику Windows Run-Time. |
| Целевая платформа | Windows |
| Header | msi.h |
| Библиотека | Msi.lib |
| DLL | Msi.dll |
См. также раздел
Не поддерживается в установщике Windows 2.0 и более ранних версий