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

Статья
03/09/2024

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

Синтаксис

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

Параметры

[in] StringSid

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

Строка идентификатора безопасности может использовать либо стандартный S-R-I-S-... формат для строк sid или формат константы строки SID, например "BA" для встроенных администраторов. Дополнительные сведения о нотации строк sid см. в разделе Компоненты SID.

[out] Sid

Указатель на переменную, которая получает указатель на преобразованный идентификатор безопасности. Чтобы освободить возвращенный буфер, вызовите функцию LocalFree .

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

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

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

Код возврата	Описание
ERROR_INVALID_PARAMETER	Недопустимый параметр.
ERROR_INVALID_SID	Недопустимый идентификатор безопасности.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	sddl.h
Библиотека	Advapi32.lib
DLL	Advapi32.dll