Функция RtlConvertSidToUnicodeString (winternl.h)

Статья
02/01/2024

[Функция RtlConvertSidToUnicodeString доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте функцию ConvertSidToStringSid .]

Функция RtlConvertSidToUnicodeString преобразует идентификатор безопасности (SID) в его символьное представление в Юникоде. У этой функции нет связанной библиотеки импорта. Для динамического связывания с Ntdll.dll необходимо использовать функции LoadLibrary и GetProcAddress .

Синтаксис

NTSTATUS RtlConvertSidToUnicodeString(
  [out] PUNICODE_STRING UnicodeString,
  [in]  PSID            Sid,
  [in]  BOOLEAN         AllocateDestinationString
);

Параметры

[out] UnicodeString

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

[in] Sid

Указатель на структуру SID , представляющую идентификатор безопасности.

[in] AllocateDestinationString

Если задано значение TRUE, unicodeString выделяется от имени вызывающей стороны, и он отвечает за освобождение выделенной памяти путем вызова функции RtlFreeUnicodeString . Если значение РАВНО FALSE, вызывающий объект отвечает за выделение и освобождение ЮникодString.

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

Возвращаемое значение — это код NTSTATUS. При успешном выполнении функции возвращается значение STATUS_SUCCESS (0x00000000L).

Требования

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