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

Статья
11/20/2024

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

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

Синтаксис

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

Параметры

[in] Sid

Указатель на структуру sid для преобразования.

[out] StringSid

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

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

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

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

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

Замечания

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

Заметка

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

Требования

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