Fungsi Global Keamanan

Fungsi-fungsi ini menyediakan dukungan untuk memodifikasi objek SID dan ACL.

Penting

Fungsi yang tercantum dalam tabel berikut tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime.

Nama	Deskripsi
AtlGetDacl	Panggil fungsi ini untuk mengambil informasi daftar kontrol akses diskresi (DACL) dari objek tertentu.
AtlSetDacl	Panggil fungsi ini untuk mengatur informasi daftar kontrol akses diskresi (DACL) dari objek tertentu.
AtlGetGroupSid	Panggil fungsi ini untuk mengambil pengidentifikasi keamanan grup (SID) objek.
AtlSetGroupSid	Panggil fungsi ini untuk mengatur pengidentifikasi keamanan grup (SID) objek.
AtlGetOwnerSid	Panggil fungsi ini untuk mengambil pengidentifikasi keamanan pemilik (SID) objek.
AtlSetOwnerSid	Panggil fungsi ini untuk mengatur pengidentifikasi keamanan pemilik (SID) objek.
AtlGetSacl	Panggil fungsi ini untuk mengambil informasi daftar kontrol akses sistem (SACL) dari objek tertentu.
AtlSetSacl	Panggil fungsi ini untuk mengatur informasi daftar kontrol akses sistem (SACL) dari objek tertentu.
AtlGetSecurityDescriptor	Panggil fungsi ini untuk mengambil pendeskripsi keamanan objek tertentu.

Persyaratan

Header: atlsecurity.h

AtlGetDacl

Panggil fungsi ini untuk mengambil informasi daftar kontrol akses diskresi (DACL) dari objek tertentu.

Penting

Fungsi ini tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime.

inline bool AtlGetDacl(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    CDacl* pDacl) throw();

Parameter

hObject
Tangani ke objek untuk mengambil informasi keamanan.

ObjectType
Menentukan nilai dari enumerasi SE_OBJECT_TYPE yang menunjukkan jenis objek yang diidentifikasi oleh parameter hObject .

pDacl
Pointer ke objek DACL yang akan berisi informasi keamanan yang diambil.

Tampilkan Nilai

Mengembalikan true pada keberhasilan, salah pada kegagalan.

Keterangan

Dalam build debug, kesalahan pernyataan akan terjadi jika hObject atau pDacl tidak valid.

AtlSetDacl

Panggil fungsi ini untuk mengatur informasi daftar kontrol akses diskresi (DACL) dari objek tertentu.

Penting

Fungsi ini tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime.

inline bool AtlSetDacl(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    const CDacl& rDacl,
    DWORD dwInheritanceFlowControl = 0) throw(...);

Parameter

hObject
Tangani ke objek untuk mengatur informasi keamanan.

ObjectType
Menentukan nilai dari enumerasi SE_OBJECT_TYPE yang menunjukkan jenis objek yang diidentifikasi oleh parameter hObject .

rDacl
DACL yang berisi informasi keamanan baru.

dwInheritanceFlowControl
Kontrol alur warisan. Nilai ini bisa 0 (default), PROTECTED_DACL_SECURITY_INFORMATION atau UNPROTECTED_DACL_SECURITY_INFORMATION.

Tampilkan Nilai

Mengembalikan true pada keberhasilan, salah pada kegagalan.

Keterangan

Dalam build debug, kesalahan pernyataan akan terjadi jika hObject tidak valid, atau jika dwInheritanceFlowControl bukan salah satu dari tiga nilai yang diizinkan.

Persyaratan

Header: atlsecurity.h

AtlGetGroupSid

Panggil fungsi ini untuk mengambil pengidentifikasi keamanan grup (SID) objek.

Penting

Fungsi ini tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime.

inline bool AtlGetGroupSid(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    CSid* pSid) throw(...);

Parameter

hObject
Tangani ke objek tempat untuk mengambil informasi keamanan.

ObjectType
Menentukan nilai dari enumerasi SE_OBJECT_TYPE yang menunjukkan jenis objek yang diidentifikasi oleh parameter hObject .

pSid
Penunjuk CSid ke objek yang akan berisi informasi keamanan baru.

Tampilkan Nilai

Mengembalikan true pada keberhasilan, salah pada kegagalan.

Persyaratan

Header: atlsecurity.h

AtlSetGroupSid

Panggil fungsi ini untuk mengatur pengidentifikasi keamanan grup (SID) objek.

Penting

Fungsi ini tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime.

inline bool AtlSetGroupSid(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    const CSid& rSid) throw(...);

Parameter

hObject
Tangani ke objek untuk mengatur informasi keamanan.

ObjectType
Menentukan nilai dari enumerasi SE_OBJECT_TYPE yang menunjukkan jenis objek yang diidentifikasi oleh parameter hObject .

rSid
Objek CSid yang berisi informasi keamanan baru.

Tampilkan Nilai

Mengembalikan true pada keberhasilan, salah pada kegagalan.

Persyaratan

Header: atlsecurity.h

AtlGetOwnerSid

Panggil fungsi ini untuk mengambil pengidentifikasi keamanan pemilik (SID) objek.

Penting

Fungsi ini tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime.

inline bool AtlGetOwnerSid(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    CSid* pSid) throw(...);

Parameter

hObject
Tangani ke objek tempat untuk mengambil informasi keamanan.

ObjectType
Menentukan nilai dari enumerasi SE_OBJECT_TYPE yang menunjukkan jenis objek yang diidentifikasi oleh parameter hObject .

pSid
Penunjuk CSid ke objek yang akan berisi informasi keamanan baru.

Tampilkan Nilai

Mengembalikan true pada keberhasilan, salah pada kegagalan.

Persyaratan

Header: atlsecurity.h

AtlSetOwnerSid

Panggil fungsi ini untuk mengatur pengidentifikasi keamanan pemilik (SID) objek.

Penting

Fungsi ini tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime.

inline bool AtlSetOwnerSid(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    const CSid& rSid) throw(...);

Parameter

hObject
Tangani ke objek untuk mengatur informasi keamanan.

ObjectType
Menentukan nilai dari enumerasi SE_OBJECT_TYPE yang menunjukkan jenis objek yang diidentifikasi oleh parameter hObject .

rSid
Objek CSid yang berisi informasi keamanan baru.

Tampilkan Nilai

Mengembalikan true pada keberhasilan, salah pada kegagalan.

Persyaratan

Header: atlsecurity.h

AtlGetSacl

Panggil fungsi ini untuk mengambil informasi daftar kontrol akses sistem (SACL) dari objek tertentu.

Penting

Fungsi ini tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime.

inline bool AtlGetSacl(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    CSacl* pSacl,
    bool bRequestNeededPrivileges = true) throw(...);

Parameter

hObject
Tangani ke objek tempat untuk mengambil informasi keamanan.

ObjectType
Menentukan nilai dari enumerasi SE_OBJECT_TYPE yang menunjukkan jenis objek yang diidentifikasi oleh parameter hObject .

pSacl
Pointer ke objek SACL yang akan berisi informasi keamanan yang diambil.

bRequestNeededPrivileges
Jika true, fungsi akan mencoba mengaktifkan hak istimewa SE_SECURITY_NAME, dan memulihkannya setelah selesai.

Tampilkan Nilai

Mengembalikan true pada keberhasilan, salah pada kegagalan.

Keterangan

Jika AtlGetSacl dipanggil berkali-kali pada banyak objek yang berbeda, akan lebih efisien untuk mengaktifkan hak istimewa SE_SECURITY_NAME sekali sebelum memanggil fungsi, dengan bRequestNeededPrivileges diatur ke false.

Persyaratan

Header: atlsecurity.h

AtlSetSacl

Panggil fungsi ini untuk mengatur informasi daftar kontrol akses sistem (SACL) dari objek tertentu.

Penting

Fungsi ini tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime.

inline bool AtlSetSacl(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    const CSacl& rSacl,
    DWORD dwInheritanceFlowControl = 0,
    bool bRequestNeededPrivileges = true) throw(...);

Parameter

hObject
Tangani ke objek untuk mengatur informasi keamanan.

ObjectType
Menentukan nilai dari enumerasi SE_OBJECT_TYPE yang menunjukkan jenis objek yang diidentifikasi oleh parameter hObject .

rSacl
SACL yang berisi informasi keamanan baru.

dwInheritanceFlowControl
Kontrol alur warisan. Nilai ini bisa 0 (default), PROTECTED_SACL_SECURITY_INFORMATION atau UNPROTECTED_SACL_SECURITY_INFORMATION.

bRequestNeededPrivileges
Jika true, fungsi akan mencoba mengaktifkan hak istimewa SE_SECURITY_NAME, dan memulihkannya setelah selesai.

Tampilkan Nilai

Mengembalikan true pada keberhasilan, salah pada kegagalan.

Keterangan

Dalam build debug, kesalahan pernyataan akan terjadi jika hObject tidak valid, atau jika dwInheritanceFlowControl bukan salah satu dari tiga nilai yang diizinkan.

Jika AtlSetSacl dipanggil berkali-kali pada banyak objek yang berbeda, akan lebih efisien untuk mengaktifkan hak istimewa SE_SECURITY_NAME sekali sebelum memanggil fungsi, dengan bRequestNeededPrivileges diatur ke false.

Persyaratan

Header: atlsecurity.h

AtlGetSecurityDescriptor

Panggil fungsi ini untuk mengambil pendeskripsi keamanan objek tertentu.

Penting

Fungsi ini tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime.

inline bool AtlGetSecurityDescriptor(
    LPCTSTR pszObjectName,
    SE_OBJECT_TYPE ObjectType,
    CSecurityDesc* pSecurityDescriptor,
    SECURITY_INFORMATION requestedInfo = OWNER_SECURITY_INFORMATION |
    GROUP_SECURITY_INFORMATION | DACL_SECURITY_INFORMATION |
    SACL_SECURITY_INFORMATION,
bool bRequestNeededPrivileges = true) throw(...);

Parameter

pszObjectName
Penunjuk ke string null-terminated yang menentukan nama objek untuk mengambil informasi keamanan.

ObjectType
Menentukan nilai dari enumerasi SE_OBJECT_TYPE yang menunjukkan jenis objek yang diidentifikasi oleh parameter pszObjectName .

pSecurityDescriptor
Objek yang menerima pendeskripsi keamanan yang diminta.

requestedInfo
Sekumpulan bendera bit SECURITY_INFORMATION yang menunjukkan jenis informasi keamanan yang akan diambil. Parameter ini bisa menjadi kombinasi dari nilai berikut.

bRequestNeededPrivileges
Jika true, fungsi akan mencoba mengaktifkan hak istimewa SE_SECURITY_NAME, dan memulihkannya setelah selesai.

Tampilkan Nilai

Mengembalikan true pada keberhasilan, salah pada kegagalan.

Keterangan

Jika AtlGetSecurityDescriptor dipanggil berkali-kali pada banyak objek yang berbeda, akan lebih efisien untuk mengaktifkan hak istimewa SE_SECURITY_NAME sekali sebelum memanggil fungsi, dengan bRequestNeededPrivileges diatur ke false.

Persyaratan

Header: atlsecurity.h

Lihat juga

Fungsi