Fungsi ConvertSidToStringSidA (sddl.h)

Artikel
03/04/2024

Fungsi ConvertSidToStringSid mengonversi pengidentifikasi keamanan (SID) ke format string yang cocok untuk tampilan, penyimpanan, atau transmisi.

Untuk mengonversi SID format string kembali ke SID fungsional yang valid, panggil fungsi ConvertStringSidToSid .

Sintaks

BOOL ConvertSidToStringSidA(
  [in]  PSID  Sid,
  [out] LPSTR *StringSid
);

Parameter

[in] Sid

Penunjuk ke struktur SID yang akan dikonversi.

[out] StringSid

Penunjuk ke variabel yang menerima penunjuk ke string SID yang dihentikan null. Untuk membebaskan buffer yang dikembalikan, panggil fungsi LocalFree .

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError. Fungsi GetLastError dapat mengembalikan salah satu kode kesalahan berikut.

Menampilkan kode	Deskripsi
ERROR_NOT_ENOUGH_MEMORY	Memori tidak cukup.
ERROR_INVALID_SID	SID tidak valid.
ERROR_INVALID_PARAMETER	Salah satu parameter berisi nilai yang tidak valid. Ini paling sering merupakan pointer yang tidak valid.

Keterangan

Fungsi ConvertSidToStringSid menggunakan S-R-I-S S- standar... format untuk string SID. Untuk informasi selengkapnya tentang notasi string SID, lihat Komponen SID.

Catatan

Header sddl.h mendefinisikan ConvertSidToStringSid sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	sddl.h
Pustaka	Advapi32.lib
DLL	Advapi32.dll