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


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

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

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

Синтаксис

BOOL ConvertSidToStringSidW(
  [in]  PSID   Sid,
  [out] LPWSTR *StringSid
);

Параметры

[in] 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 см. в разделе Компоненты 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