Fungsi DSCreateSecurityPage (dssec.h)

Artikel
08/23/2023

Fungsi DSCreateSecurityPage membuat halaman properti keamanan untuk objek Direktori Aktif. Halaman properti yang dihasilkan dapat ditambahkan ke lembar properti.

Sintaks

HRESULT DSCreateSecurityPage(
  [in]           LPCWSTR                pwszObjectPath,
  [in, optional] LPCWSTR                pwszObjectClass,
  [in]           DWORD                  dwFlags,
  [out]          HPROPSHEETPAGE         *phPage,
  [in, optional] PFNREADOBJECTSECURITY  pfnReadSD,
  [in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
  [in]           LPARAM                 lpContext
);

Parameter

[in] pwszObjectPath

Penunjuk ke string karakter lebar yang dihentikan null yang mewakili jalur Direktori Aktif penuh untuk objek.

[in, optional] pwszObjectClass

Penunjuk ke string karakter lebar yang dihentikan null yang mewakili kelas objek. Nilai ini bisa NULL.

[in] dwFlags

Bendera yang digunakan untuk halaman properti keamanan. Parameter ini tidak boleh ada atau kombinasi dari bendera berikut.

Nilai	Makna
DSSI_READ_ONLY 0x00000001	Properti keamanan bersifat baca-saja.
DSSI_NO_ACCESS_CHECK 0x00000002	Tidak ada pemeriksaan akses yang dilakukan.
DSSI_NO_EDIT_SACL 0x00000004	Properti daftar kontrol akses sistem (SACL) bersifat baca-saja.
DSSI_NO_EDIT_OWNER 0x00000008	Properti pemilik objek bersifat baca-saja.
DSSI_IS_ROOT 0x00000010	Objek adalah objek akar.
DSSI_NO_FILTER 0x00000020	Jangan terapkan filter apa pun.
DSSI_NO_READONLY_MESSAGE 0x00000040	Sembunyikan pesan popup baca-saja.

[out] phPage

Penunjuk ke HPROPSHEETPAGE yang mengembalikan halaman properti keamanan yang dibuat.

[in, optional] pfnReadSD

Penunjuk ke fungsi yang digunakan untuk membaca deskriptor keamanan objek. Nilai ini bisa NULL. Jika pfnReadSD bukan NULL, DSCreateSecurityPage memanggil fungsi yang direferensikan oleh pfnReadSD untuk mengambil pendeskripsi keamanan objek.

[in, optional] pfnWriteSD

Penunjuk ke fungsi yang digunakan untuk menulis deskriptor keamanan objek. Nilai ini bisa NULL. Jika pfnWriteSD bukan NULL, DSCreateSecurityPage memanggil fungsi yang direferensikan oleh pfnWriteSD untuk menulis deskriptor keamanan objek.

[in] lpContext

Konteks untuk diteruskan ke fungsi yang diidentifikasi oleh pfnReadSD atau pfnWriteSD.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Keterangan

Fungsi yang ditujukkan oleh pfnReadSD didefinisikan sebagai berikut.

#include <windows.h>

typedef HRESULT (WINAPI *PFNREADOBJECTSECURITY)(
    LPCWSTR,               // Active Directory path of object
    SECURITY_INFORMATION,  // the security information to read
    PSECURITY_DESCRIPTOR*, // the returned security descriptor 
    LPARAM                 // context parameter
);

Fungsi DSCreateSecurityPage akan membebaskan deskriptor keamanan yang dikembalikan dalam parameter ketiga di atas dengan panggilan ke fungsi LocalFree .

Fungsi yang diarahkan oleh pfnWriteSD didefinisikan sebagai berikut.

#include <windows.h>

typedef HRESULT (WINAPI *PFNWRITEOBJECTSECURITY)(
    LPCWSTR,              // Active Directory path of object
    SECURITY_INFORMATION, // the security information to write
    PSECURITY_DESCRIPTOR, // the security descriptor to write
    LPARAM                // context parameter
);

Persyaratan


Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	dssec.h
Pustaka	DSSec.lib
DLL	DSSec.dll

Lihat juga

Halaman Properti Keamanan Dasar

ISecurityInformation

Bagikan melalui