Bagikan melalui

Fungsi DSCreateISecurityInfoObjectEx (dssec.h)

  • Artikel

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

Sintaks

HRESULT DSCreateISecurityInfoObjectEx(
  [in]           LPCWSTR                pwszObjectPath,
  [in]           LPCWSTR                pwszObjectClass,
  [in]           LPCWSTR                pwszServer,
  [in]           LPCWSTR                pwszUserName,
  [in]           LPCWSTR                pwszPassword,
  [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] pwszServer

Server objek yang ditentukan oleh parameter pwszObjectPath . Jika nilai parameter ini adalah NULL, server diperoleh dari jalur yang ditentukan oleh parameter pwszObjectPath .

[in] pwszUserName

Nama pengguna yang akan dikaitkan dengan objek ISecurityInformation baru. Jika nilai parameter ini adalah NULL, default Active Directory Services Interfaces (ADSI) digunakan.

[in] pwszPassword

Kata sandi yang akan dikaitkan dengan objek ISecurityInformation baru. Jika nilai parameter ini adalah NULL, default Active Directory Services Interfaces (ADSI) digunakan.

[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