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

Статья
11/20/2024

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

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

Синтаксис

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

Параметры

[in] szProduct

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

[in] szUserName

Имя пользователя для установки на пользователя. В Windows 2000 или Windows XP имя пользователя всегда должно быть в формате DOMAIN\USERNAME (или MACHINENAME\USERNAME для локального пользователя).

Пустая строка или 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".
целевая платформа	Виндоус
заголовка	msi.h
библиотеки	Msi.lib
DLL	Msi.dll