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

Статья
08/25/2023

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

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

Синтаксис

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

Параметры

[in] Sid

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

[out] StringSid

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

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

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

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

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

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

Требования


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