Fungsi ConvertStringSidToSidA (sddl.h)

Artikel
03/08/2023

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
ERROR_INVALID_PARAMETER	Parameter tidak valid.
ERROR_INVALID_SID	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