Функция ConvertStringSidToSidA (sddl.h)

Статья
11/20/2024

Функция ConvertStringSidToSid преобразует строковый идентификатор идентификатор безопасности (SID) в допустимый функциональный идентификатор безопасности. Эту функцию можно использовать для получения идентификатора безопасности, преобразованного в строковый формат ConvertS idToStringSid.

Синтаксис

BOOL ConvertStringSidToSidA(
  [in]  LPCSTR StringSid,
  [out] PSID   *Sid
);

Параметры

[in] StringSid

Указатель на строку, завершающуюся значением NULL, содержащую идентификатор безопасности строкового формата для преобразования.

Строка БЕЗОПАСНОСТИ может использовать стандартнуюR-S-S-S... Формат строк БЕЗОПАСНОСТИ или формат константы строки SID, например BA для встроенных администраторов. Дополнительные сведения о нотации строк безопасности см. в компонентах БЕЗОПАСНОСТИ.

[out] Sid

Указатель на переменную, получающую указатель на преобразованный идентификатор БЕЗОПАСНОСТИ. Чтобы освободить возвращенный буфер, вызовите функцию LocalFree.

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

Если функция выполнена успешно, возвращаемое значение ненулевое.

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

Возвращаемый код	Описание
ERROR_INVALID_PARAMETER	Недопустимый параметр.
ERROR_INVALID_SID	Недопустимый идентификатор БЕЗОПАСНОСТИ.

Замечания

Заметка

Заголовок sddl.h определяет ConvertStringSidToSid Как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [классические приложения \| Приложения UWP]
минимальный поддерживаемый сервер	Windows Server 2003 [классические приложения \| Приложения UWP]
целевая платформа	Виндоус
заголовка	sddl.h
библиотеки	Advapi32.lib
DLL	Advapi32.dll