Поделиться через


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

Функция 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

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

Обзор контроль доступа

Базовые функции контроль доступа

ConvertSecurityDescriptorToStringSecurityDescriptor

ConvertStringSecurityDescriptorToSecurityDescriptor

ConvertStringSidToSid

SID