Fungsi ConvertStringSidToSidA (sddl.h)
Fungsi ConvertStringSidToSid mengonversi pengidentifikasi keamanan format string (SID) menjadi SID fungsional yang valid. Anda dapat menggunakan fungsi ini untuk mengambil SID yang dikonversi fungsi ConvertSidToStringSid ke format string.
Sintaks
BOOL ConvertStringSidToSidA(
[in] LPCSTR StringSid,
[out] PSID *Sid
);
Parameter
[in] StringSid
Penunjuk ke string yang dihentikan null yang berisi SID format string untuk dikonversi.
String SID dapat menggunakan S-R-I-S S-standar... format untuk string SID, atau format konstanta string SID, seperti "BA" untuk administrator bawaan. Untuk informasi selengkapnya tentang notasi string SID, lihat Komponen SID.
[out] Sid
Penunjuk ke variabel yang menerima pointer ke SID yang dikonversi. Untuk membebaskan buffer yang dikembalikan, panggil fungsi LocalFree .
Nilai kembali
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 |
---|---|
|
Parameter tidak valid. |
|
SID tidak valid. |
Keterangan
Catatan
Header sddl.h mendefinisikan ConvertStringSidToSid 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