Fungsi RtlConvertSidToUnicodeString (winternl.h)

[Fungsi RtlConvertSidToUnicodeString tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya. Sebagai gantinya, gunakan fungsi ConvertSidToStringSid .]

Fungsi RtlConvertSidToUnicodeString mengonversi pengidentifikasi keamanan (SID) ke representasi karakter Unicode-nya. Fungsi ini tidak memiliki pustaka impor terkait. Anda harus menggunakan fungsi LoadLibrary dan GetProcAddress untuk menautkan secara dinamis ke Ntdll.dll.

Sintaks

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

Parameter

[out] UnicodeString

Penunjuk ke representasi karakter Unicode dari pengidentifikasi keamanan.

[in] Sid

Penunjuk ke struktur SID yang mewakili pengidentifikasi keamanan.

[in] AllocateDestinationString

Jika TRUE, maka UnicodeString dialokasikan atas nama pemanggil, dan pemanggil bertanggung jawab untuk membebaskan memori yang dialokasikan dengan memanggil fungsi RtlFreeUnicodeString . Jika FALSE, pemanggil bertanggung jawab untuk mengalokasikan dan membebaskan UnicodeString.

Mengembalikan nilai

Nilai yang dikembalikan adalah kode NTSTATUS. Nilai STATUS_SUCCESS (0x00000000L) dikembalikan jika fungsi berhasil.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winternl.h
Pustaka	ntdll.lib
DLL	ntdll.dll