Fungsi ConvertSidToStringSidA (sddl.h)
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 |
---|---|
|
Memori tidak cukup. |
|
SID tidak valid. |
|
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 |
Lihat juga
ConvertSecurityDescriptorToStringSecurityDescriptor