Fungsi ConvertSecurityDescriptorToStringSecurityDescriptorA (sddl.h)

Artikel
2024-11-20

Fungsi ConvertSecurityDescriptorToStringSecurityDescriptor mengonversi pendeskripsi keamanan ke format string. Anda dapat menggunakan format string untuk menyimpan atau mengirimkan deskriptor keamanan.

Untuk mengonversi deskriptor keamanan format string kembali ke deskriptor keamanan fungsional yang valid, panggil fungsi ConvertStringSecurityDescriptorToSecurityDescriptor.

Sintaksis

BOOL ConvertSecurityDescriptorToStringSecurityDescriptorA(
  [in]  PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in]  DWORD                RequestedStringSDRevision,
  [in]  SECURITY_INFORMATION SecurityInformation,
  [out] LPSTR                *StringSecurityDescriptor,
  [out] PULONG               StringSecurityDescriptorLen
);

Parameter

[in] SecurityDescriptor

Penunjuk ke deskriptor keamanan untuk dikonversi. Deskriptor keamanan dapat dalam format absolut atau relatif mandiri.

[in] RequestedStringSDRevision

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

[in] SecurityInformation

Menentukan kombinasi bendera bit SECURITY_INFORMATION untuk menunjukkan komponen deskriptor keamanan untuk disertakan dalam string output.

Bendera BACKUP_SECURITY_INFORMATION tidak berlaku untuk fungsi ini. Jika bendera BACKUP_SECURITY_INFORMATION diteruskan, parameter SecurityInformation mengembalikan TRUE dengan output string null .

[out] StringSecurityDescriptor

Penunjuk ke variabel yang menerima penunjuk ke string deskriptor keamanannull dihentikan. Untuk deskripsi format string, lihat Format String Deskriptor Keamanan . Untuk membebaskan buffer yang dikembalikan, panggil fungsi LocalFree.

[out] StringSecurityDescriptorLen

Penunjuk ke variabel yang menerima ukuran, dalam TCHAR, dari string deskriptor keamanan yang dikembalikan dalam StringSecurityDescriptor buffer. Parameter ini dapat NULL jika Anda tidak perlu mengambil ukurannya. Ukuran menunjukkan ukuran buffer dalamWCHAR , bukan jumlah WCHARdalam string.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

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

Mengembalikan kode	Deskripsi
ERROR_INVALID_PARAMETER	Parameter tidak valid.
ERROR_UNKNOWN_REVISION	Tingkat revisi tidak valid.
ERROR_NONE_MAPPED	Pengidentifikasi keamanan (SID) dalam deskriptor keamanan input tidak dapat ditemukan dalam operasi pencarian akun.
ERROR_INVALID_ACL	Daftar kontrol akses (ACL) tidak valid. Kesalahan ini dikembalikan jika bendera SE_DACL_PRESENT diatur dalam deskriptor keamanan input dan DACL NULL.

Komentar

Jika DACL NULL, dan bit kontrol SE_DACL_PRESENT diatur dalam deskriptor keamanan input, fungsi gagal.

Jika DACL NULL, dan bit kontrol SE_DACL_PRESENT tidak diatur dalam deskriptor keamanan input, string deskriptor keamanan yang dihasilkan tidak memiliki komponen D: . Untuk informasi selengkapnya, lihat Format String Deskriptor Keamanan .

Nota

Header sddl.h mendefinisikan ConvertSecurityDescriptorToStringSecurityDescriptor 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

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

Lihat juga

Gambaran Umum Kontrol Akses

Fungsi Kontrol Akses Dasar

ConvertSidToStringSid

ConvertStringSecurityDescriptorToSecurityDescriptor

ConvertStringSidToSid

SECURITY_DESCRIPTOR

SECURITY_INFORMATION

Bagikan melalui