Freigeben über

RtlConvertSidToUnicodeString-Funktion (winternl.h)

  • Artikel

[Die RtlConvertSidToUnicodeString-Funktion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen die Funktion ConvertSidToStringSid .]

Die RtlConvertSidToUnicodeString-Funktion konvertiert einen Sicherheitsbezeichner (SID) in seine Unicode-Zeichendarstellung. Diese Funktion verfügt über keine zugeordnete Importbibliothek. Sie müssen die Funktionen LoadLibrary und GetProcAddress verwenden, um eine dynamische Verknüpfung mit Ntdll.dll.

Syntax

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

Parameter

[out] UnicodeString

Ein Zeiger auf die Unicode-Zeichendarstellung des Sicherheitsbezeichners.

[in] Sid

Ein Zeiger auf die SID-Struktur , die den Sicherheitsbezeichner darstellt.

[in] AllocateDestinationString

Wenn TRUE, wird UnicodeString im Namen des Aufrufers zugeordnet, und es liegt in der Verantwortung des Aufrufers, den zugewiesenen Arbeitsspeicher durch Aufrufen der RtlFreeUnicodeString-Funktion freizugeben. Bei FALSE ist der Aufrufer für die Zuweisung und Freigabe von UnicodeString verantwortlich.

Rückgabewert

Der Rückgabewert ist ein NTSTATUS-Code. Ein Wert von STATUS_SUCCESS (0x00000000L) wird zurückgegeben, wenn die Funktion erfolgreich ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winternl.h
Bibliothek ntdll.lib
DLL ntdll.dll