Функция RtlConvertSidToUnicodeString (winternl.h)
[Функция 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 |