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

Статья
08/24/2023

Функция MsiSourceListAddSource добавляет в список допустимых сетевых источников, содержащих указанный тип источников для продукта или исправления в указанном пользовательском контексте.

Количество источников в свойстве SOURCELIST не ограничено.

Синтаксис

UINT MsiSourceListAddSourceW(
  [in] LPCWSTR szProduct,
  [in] LPCWSTR szUserName,
  [in] DWORD   dwReserved,
  [in] LPCWSTR szSource
);

Параметры

[in] szProduct

Код продукта для изменения.

[in] szUserName

Имя пользователя для установки на пользователя. В Windows 2000 или Windows XP имя пользователя всегда должно быть в формате ДОМЕН\ИМЯ_ПОЛЬЗОВАТЕЛЯ (или ИМЯ_КОМПЬЮТЕРА\ИМЯ_ПОЛЬЗОВАТЕЛЯ для локального пользователя).

Пустая строка или ЗНАЧЕНИЕ NULL для установки на отдельный компьютер.

[in] dwReserved

Зарезервировано для последующего использования. Это значение должно быть равно 0.

[in] szSource

Указатель на строку, указывающую источник.

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

Код возврата	Описание
ERROR_ACCESS_DENIED	У пользователя нет возможности добавить источник.
ERROR_BAD_CONFIGURATION	Данные конфигурации повреждены.
ERROR_BAD_USERNAME	Не удалось разрешить имя пользователя.
ERROR_FUNCTION_FAILED	Функция не выполнена.
ERROR_INSTALL_SERVICE_FAILURE	Не удалось получить доступ к службе установщика.
ERROR_INVALID_PARAMETER	В функцию передан недопустимый параметр.
ERROR_SUCCESS	Источник добавлен.
ERROR_UNKNOWN_PRODUCT	Указанный продукт неизвестен.

Администратор может изменять установки для каждого компьютера, собственные неуправляемые установки для каждого пользователя и управляемые установки для каждого пользователя. Неадминистратор может изменять только установки для каждого компьютера и собственные (управляемые или неуправляемые) установки для каждого пользователя. Пользователям можно включить поиск источников, задав политику. Дополнительные сведения см. в разделах Политики DisableBrowse, AllowLockdownBrowse и AlwaysInstallElevated .

Обратите внимание, что эта функция просто добавляет новый источник в список допустимых источников. Если для установки продукта использовался другой источник, новый источник не используется, пока текущий источник не будет недоступен.

Вызывающий объект несет ответственность за обеспечение того, чтобы предоставленный источник был допустимым исходным образом для продукта.

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

Если имя пользователя не является пустой строкой или значением NULL, оно указывает имя пользователя, установка продукта которого изменена. Если имя пользователя является текущим именем пользователя, функция сначала пытается изменить неуправляемую установку продукта. Если неуправляемая установка продукта не найдена, функция пытается изменить управляемую установку продукта для каждого пользователя. Если не удается найти управляемые или неуправляемые установки продукта для каждого пользователя, функция возвращает ERROR_UNKNOWN_PRODUCT, даже если продукт установлен для каждого компьютера.

Эта функция не может изменить неуправляемую установку для любого пользователя, кроме текущего пользователя. Если имя пользователя не является пустой строкой или значением NULL, но не является текущим пользователем, функция проверяет только управляемую установку продукта для указанного пользователя. Если продукт не установлен как управляемый для каждого пользователя для указанного пользователя, функция возвращает ERROR_UNKNOWN_PRODUCT, даже если продукт установлен на каждом компьютере.

Примечание

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