Fungsi ConvertStringSecurityDescriptorToSecurityDescriptorA (sddl.h)

Artikel
08/25/2023

Fungsi ConvertStringSecurityDescriptorToSecurityDescriptor mengonversi deskriptor keamanan format string menjadi deskriptor keamanan fungsional yang valid. Fungsi ini mengambil deskriptor keamanan yang dikonversi fungsi ConvertSecurityDescriptorToStringSecurityDescriptor ke format string.

Sintaks

BOOL ConvertStringSecurityDescriptorToSecurityDescriptorA(
  [in]  LPCSTR               StringSecurityDescriptor,
  [in]  DWORD                StringSDRevision,
  [out] PSECURITY_DESCRIPTOR *SecurityDescriptor,
  [out] PULONG               SecurityDescriptorSize
);

Parameter

[in] StringSecurityDescriptor

Penunjuk ke string yang dihentikan null yang berisi deskriptor keamanan format string untuk dikonversi.

[in] StringSDRevision

Menentukan tingkat revisi string StringSecurityDescriptor . Saat ini nilai ini harus SDDL_REVISION_1.

[out] SecurityDescriptor

Penunjuk ke variabel yang menerima penunjuk ke deskriptor keamanan yang dikonversi. Pendeskripsi keamanan yang dikembalikan adalah relatif mandiri. Untuk membebaskan buffer yang dikembalikan, panggil fungsi LocalFree . Untuk mengonversi deskriptor keamanan menjadi deskriptor keamanan absolut, gunakan fungsi MakeAbsoluteSD .

[out] SecurityDescriptorSize

Penunjuk ke variabel yang menerima ukuran, dalam byte, dari deskriptor keamanan yang dikonversi. Parameter ini bisa NULL.

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. GetLastError dapat mengembalikan salah satu kode kesalahan berikut.

Menampilkan kode	Deskripsi
ERROR_INVALID_PARAMETER	Parameter tidak valid.
ERROR_UNKNOWN_REVISION	Tingkat revisi SDDL tidak valid.
ERROR_NONE_MAPPED	Pengidentifikasi keamanan (SID) dalam string deskriptor keamanan input tidak dapat ditemukan dalam operasi pencarian akun.

Keterangan

Jika ace_type ACCESS_ALLOWED_OBJECT_ACE_TYPE dan tidak object_guid atau inherit_object_guid memiliki GUID yang ditentukan, maka ConvertStringSecurityDescriptorToSecurityDescriptor mengonversi ace_type menjadi ACCESS_ALLOWED_ACE_TYPE. Untuk informasi tentang bidang ace_type, object_guid, dan inherit_object_guid , lihat String Ace.

Catatan

Header sddl.h mendefinisikan ConvertStringSecurityDescriptorToSecurityDescriptor sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor 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