Fungsi DSCreateISecurityInfoObject (dssec.h)

Artikel
08/23/2023

Fungsi DSCreateISecurityInfoObject membuat instans antarmuka ISecurityInformation yang terkait dengan objek layanan direktori (DS) yang ditentukan.

Sintaks

HRESULT DSCreateISecurityInfoObject(
  [in]           LPCWSTR                pwszObjectPath,
  [in]           LPCWSTR                pwszObjectClass,
  [in]           DWORD                  dwFlags,
  [out]          LPSECURITYINFO         *ppSI,
  [in, optional] PFNREADOBJECTSECURITY  pfnReadSD,
  [in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
  [in]           LPARAM                 lpContext
);

Parameter

[in] pwszObjectPath

Jalur lengkap objek DS untuk membuat instans antarmuka ISecurityInformation .

[in] pwszObjectClass

Kelas objek yang ditentukan oleh parameter pwszObjectPath .

[in] dwFlags

Bendera yang digunakan untuk halaman properti keamanan yang terkait dengan instans baru antarmuka ISecurityInformation . Parameter ini dapat berupa 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] ppSI

Penunjuk ke instans antarmuka ISecurityInformation yang dibuat fungsi ini.

[in, optional] pfnReadSD

Penunjuk ke fungsi yang digunakan untuk membaca pendeskripsi keamanan objek. Nilai ini bisa NULL. Jika pfnReadSD bukan NULL, DSCreateISecurityInfoObject 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, DSCreateISecurityInfoObject memanggil fungsi yang direferensikan oleh pfnWriteSD untuk menulis deskriptor keamanan objek.

[in] lpContext

Konteks untuk diteruskan ke fungsi yang diidentifikasi oleh parameter pfnReadSD dan 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.

Persyaratan


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

Bagikan melalui