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

Статья
11/20/2024

Функция MsiNotifySidChange уведомляет и обновляет внутреннюю информацию установщика Windows с изменениями идентификаторов безопасности пользователей.

Синтаксис

UINT MsiNotifySidChangeW(
  [in] LPCWSTR pOldSid,
  [in] LPCWSTR pNewSid
);

Параметры

[in] pOldSid

Строка, завершающая значение NULL, указывающая строковое значение предыдущего идентификатора безопасности (SID).

[in] pNewSid

Строка, завершающая значение NULL, указывающая строковое значение нового идентификатора безопасности (SID).

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

Ценность	Значение
ERROR_INVALID_PARAMETER	Недопустимый параметр передается функции. Эта ошибка возвращается, если любой из параметров NULL.
ERROR_SUCCESS	Функция завершилась успешно.
ERROR_OUTOFMEMORY	Недостаточно памяти было доступно.
ERROR_FUNCTION_FAILED	Внутренний сбой во время выполнения.

Замечания

Установщик Windows 2.0 и Установщик Windows 3.0: Не поддерживается. Эта функция доступна начиная с установщика Windows 3.1.

Заметка

Заголовок msi.h определяет MsiNotifySidChange как псевдоним, который автоматически выбирает версию 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 3.1 в Windows Server 2003, Windows XP и Windows 2000. Сведения о минимальном пакете обновления Windows, требуемом версией установщика Windows, см. в разделе "Требования к установщику Windows Run-Time".
целевая платформа	Виндоус
заголовка	msi.h
библиотеки	Msi.lib
DLL	Msi.dll

См. также

не поддерживается в установщике Windows 3.0 и более ранних

Поделиться через