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

Статья
08/25/2023

Функция ConvertSidToStringSid преобразует идентификатор безопасности (SID) в формат строки, подходящий для отображения, хранения или передачи.

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

Синтаксис

BOOL ConvertSidToStringSidA(
  [in]  PSID  Sid,
  [out] LPSTR *StringSid
);

Параметры

[in] Sid

Указатель на преобразуемую структуру SID .

[out] StringSid

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

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

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

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

Код возврата	Описание
ERROR_NOT_ENOUGH_MEMORY	Недостаточно памяти.
ERROR_INVALID_SID	Недопустимый идентификатор безопасности.
ERROR_INVALID_PARAMETER	Один из параметров содержит недопустимое значение. Чаще всего это недопустимый указатель.

Функция ConvertSidToStringSid использует стандартный S-R-I-S-S... формат для строк идентификатора безопасности. Дополнительные сведения о нотации строк sid см. в разделе Компоненты SID.

Примечание

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

Требования

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