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

Статья
08/24/2023

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

Синтаксис

UINT MsiNotifySidChangeA(
  [in] LPCSTR pOldSid,
  [in] LPCSTR pNewSid
);

Параметры

[in] pOldSid

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

[in] pNewSid

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

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

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

Заголовок 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.
Целевая платформа	Windows
Header	msi.h
Библиотека	Msi.lib
DLL	Msi.dll

См. также раздел

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