Bagikan melalui


Kelas CPrivateObjectSecurityDesc

Kelas ini mewakili objek pendeskripsi keamanan objek privat.

Sintaks

class CPrivateObjectSecurityDesc : public CSecurityDesc

Anggota

Konstruktor Publik

Nama Deskripsi
CPrivateObjectSecurityDesc::CPrivateObjectSecurityDesc Konstruktor.
CPrivateObjectSecurityDesc::~CPrivateObjectSecurityDesc Destruktor.

Metode Publik

Nama Deskripsi
CPrivateObjectSecurityDesc::ConvertToAutoInherit Panggil metode ini untuk mengonversi deskriptor keamanan dan daftar kontrol akses (ACL) ke format yang mendukung penyebaran otomatis entri kontrol akses (ACL) yang dapat diwariskan.
CPrivateObjectSecurityDesc::Create Panggil metode ini untuk mengalokasikan dan menginisialisasi deskriptor keamanan relatif mandiri untuk objek privat yang dibuat oleh manajer sumber daya panggilan.
CPrivateObjectSecurityDesc::Get Panggil metode ini untuk mengambil informasi dari deskriptor keamanan objek privat.
CPrivateObjectSecurityDesc::Set Panggil metode ini untuk mengubah pendeskripsi keamanan objek privat.

Operator

Operator Deskripsi
operator = Operator penugasan.

Keterangan

Kelas ini, berasal dari CSecurityDesc, menyediakan metode untuk membuat dan mengelola pendeskripsi keamanan objek privat.

Untuk pengenalan model kontrol akses di Windows, lihat Kontrol Akses di Windows SDK.

Hierarki Warisan

CSecurityDesc

CPrivateObjectSecurityDesc

Persyaratan

Header: atlsecurity.h

CPrivateObjectSecurityDesc::ConvertToAutoInherit

Panggil metode ini untuk mengonversi deskriptor keamanan dan daftar kontrol akses (ACL) ke format yang mendukung penyebaran otomatis entri kontrol akses (ACL) yang dapat diwariskan.

bool ConvertToAutoInherit(
    const CSecurityDesc* pParent,
    GUID* ObjectType,
    bool bIsDirectoryObject,
    PGENERIC_MAPPING GenericMapping) throw();

Parameter

pParent
Penunjuk ke objek CSecurityDesc yang merujuk pada kontainer induk objek. Jika tidak ada kontainer induk, parameter ini adalah NULL.

ObjectType
Penunjuk ke GUID struktur yang mengidentifikasi jenis objek yang terkait dengan objek saat ini. Atur ObjectType ke NULL jika objek tidak memiliki GUID.

bIsDirectoryObject
Menentukan apakah objek baru dapat berisi objek lain. Nilai true menunjukkan bahwa objek baru adalah kontainer. Nilai false menunjukkan bahwa objek baru bukan kontainer.

GenericMapping
Penunjuk ke struktur GENERIC_MAPPING yang menentukan pemetaan dari setiap hak generik ke hak tertentu untuk objek.

Tampilkan Nilai

Mengembalikan true pada keberhasilan, salah pada kegagalan.

Keterangan

Metode ini mencoba menentukan apakah ACE dalam daftar kontrol akses diskresi (DACL) dan daftar kontrol akses sistem (SACL) dari deskriptor keamanan saat ini diwarisi dari deskriptor keamanan induk. Ini memanggil fungsi ConvertToAutoInheritPrivateObjectSecurity .

CPrivateObjectSecurityDesc::CPrivateObjectSecurityDesc

Konstruktor.

CPrivateObjectSecurityDesc() throw();

Keterangan

Menginisialisasi objek CPrivateObjectSecurityDesc.

CPrivateObjectSecurityDesc::~CPrivateObjectSecurityDesc

Destruktor.

~CPrivateObjectSecurityDesc() throw();

Keterangan

Destruktor membebaskan semua sumber daya yang dialokasikan dan menghapus deskriptor keamanan objek privat.

CPrivateObjectSecurityDesc::Create

Panggil metode ini untuk mengalokasikan dan menginisialisasi deskriptor keamanan relatif mandiri untuk objek privat yang dibuat oleh manajer sumber daya panggilan.

bool Create(
    const CSecurityDesc* pParent,
    const CSecurityDesc* pCreator,
    bool bIsDirectoryObject,
    const CAccessToken& Token,
    PGENERIC_MAPPING GenericMapping) throw();

bool Create(
    const CSecurityDesc* pParent,
    const CSecurityDesc* pCreator,
    GUID* ObjectType,
    bool bIsContainerObject,
    ULONG AutoInheritFlags,
    const CAccessToken& Token,
    PGENERIC_MAPPING GenericMapping) throw();

Parameter

pParent
Penunjuk ke objek CSecurityDesc yang merujuk pada direktori induk tempat objek baru sedang dibuat. Atur ke NULL jika tidak ada direktori induk.

pCreator
Penunjuk ke deskriptor keamanan yang disediakan oleh pembuat objek. Jika pembuat objek tidak secara eksplisit meneruskan informasi keamanan untuk objek baru, atur parameter ini ke NULL.

bIsDirectoryObject
Menentukan apakah objek baru dapat berisi objek lain. Nilai true menunjukkan bahwa objek baru adalah kontainer. Nilai false menunjukkan bahwa objek baru bukan kontainer.

Token
Referensi ke objek CAccessToken untuk proses klien atas nama objek sedang dibuat.

GenericMapping
Penunjuk ke struktur GENERIC_MAPPING yang menentukan pemetaan dari setiap hak generik ke hak tertentu untuk objek.

ObjectType
Penunjuk ke GUID struktur yang mengidentifikasi jenis objek yang terkait dengan objek saat ini. Atur ObjectType ke NULL jika objek tidak memiliki GUID.

bIsContainerObject
Menentukan apakah objek baru dapat berisi objek lain. Nilai true menunjukkan bahwa objek baru adalah kontainer. Nilai false menunjukkan bahwa objek baru bukan kontainer.

AutoInheritFlags
Sekumpulan bendera bit yang mengontrol bagaimana entri kontrol akses (ASE) diwarisi dari pParent. Lihat CreatePrivateObjectSecurityEx untuk detail selengkapnya.

Tampilkan Nilai

Mengembalikan true pada keberhasilan, salah pada kegagalan.

Keterangan

Metode ini memanggil CreatePrivateObjectSercurity atau CreatePrivateObjectSecurityEx.

Metode kedua memungkinkan menentukan GUID jenis objek dari objek baru atau mengontrol bagaimana ACE diwariskan.

Catatan

Deskriptor keamanan relatif mandiri adalah deskriptor keamanan yang menyimpan semua informasi keamanannya dalam blok memori yang berdekatan.

CPrivateObjectSecurityDesc::Get

Panggil metode ini untuk mengambil informasi dari deskriptor keamanan objek privat.

bool Get(
    SECURITY_INFORMATION si,
    CSecurityDesc* pResult) const throw();

Parameter

Si
Sekumpulan bendera bit yang menunjukkan bagian deskriptor keamanan untuk diambil. Nilai ini bisa menjadi kombinasi dari bendera bit SECURITY_INFORMATION .

pResult
Penunjuk ke objek CSecurityDesc yang menerima salinan informasi yang diminta dari deskriptor keamanan yang ditentukan.

Tampilkan Nilai

Mengembalikan true pada keberhasilan, salah pada kegagalan.

Keterangan

Deskriptor keamanan adalah struktur dan data terkait yang berisi informasi keamanan untuk objek yang dapat diamankan.

CPrivateObjectSecurityDesc::operator =

Operator penugasan.

CPrivateObjectSecurityDesc& operator= (const CPrivateObjectSecurityDesc& rhs) throw(...);

Parameter

rhs
Objek CPrivateObjectSecurityDesc yang akan ditetapkan ke objek saat ini.

Tampilkan Nilai

Mengembalikan objek yang diperbarui CPrivateObjectSecurityDesc .

CPrivateObjectSecurityDesc::Set

Panggil metode ini untuk mengubah pendeskripsi keamanan objek privat.

bool Set(
    SECURITY_INFORMATION si,
    const CSecurityDesc& Modification,
    PGENERIC_MAPPING GenericMapping,
    const CAccessToken& Token) throw();

bool Set(
    SECURITY_INFORMATION si,
    const CSecurityDesc& Modification,
    ULONG AutoInheritFlags,
    PGENERIC_MAPPING GenericMapping,
    const CAccessToken& Token) throw();

Parameter

Si
Sekumpulan bendera bit yang menunjukkan bagian deskriptor keamanan yang akan diatur. Nilai ini bisa menjadi kombinasi dari bendera bit SECURITY_INFORMATION .

Modifikasi
Penunjuk ke objek CSecurityDesc . Bagian dari deskriptor keamanan ini yang ditunjukkan oleh parameter si diterapkan ke deskriptor keamanan objek.

GenericMapping
Penunjuk ke struktur GENERIC_MAPPING yang menentukan pemetaan dari setiap hak generik ke hak tertentu untuk objek.

Token
Referensi ke objek CAccessToken untuk proses klien atas nama objek sedang dibuat.

AutoInheritFlags
Sekumpulan bendera bit yang mengontrol bagaimana entri kontrol akses (ASE) diwarisi dari pParent. Lihat CreatePrivateObjectSecurityEx untuk detail selengkapnya.

Tampilkan Nilai

Mengembalikan true pada keberhasilan, salah pada kegagalan.

Keterangan

Metode kedua memungkinkan menentukan GUID jenis objek objek atau mengontrol bagaimana ACE diwariskan.

Lihat juga

SECURITY_DESCRIPTOR
Gambaran Umum Kelas
Fungsi Global Keamanan
Kelas CSecurityDesc