enumerasi ADS_OPTION_ENUM (iads.h)

Artikel
08/24/2023

Jenis enumerasi ADS_OPTION_ENUM berisi nilai yang menunjukkan opsi yang dapat diambil atau diatur dengan metode IADsObjectOptions.GetOption dan IADsObjectOptions.SetOption .

Sintaks

typedef enum __MIDL___MIDL_itf_ads_0001_0077_0001 {
  ADS_OPTION_SERVERNAME = 0,
  ADS_OPTION_REFERRALS,
  ADS_OPTION_PAGE_SIZE,
  ADS_OPTION_SECURITY_MASK,
  ADS_OPTION_MUTUAL_AUTH_STATUS,
  ADS_OPTION_QUOTA,
  ADS_OPTION_PASSWORD_PORTNUMBER,
  ADS_OPTION_PASSWORD_METHOD,
  ADS_OPTION_ACCUMULATIVE_MODIFICATION,
  ADS_OPTION_SKIP_SID_LOOKUP
} ADS_OPTION_ENUM;

Konstanta


`ADS_OPTION_SERVERNAME` Nilai: 0 Mendapatkan VT_BSTR yang berisi nama host server untuk pengikatan saat ini ke objek ini. Opsi ini tidak didukung oleh Metode IADsObjectOptions.SetOption .
`ADS_OPTION_REFERRALS` Mendapatkan atau menetapkan nilai VT_I4 yang menunjukkan bagaimana pengejaran rujukan dilakukan dalam Query. Opsi ini dapat berisi salah satu nilai yang ditentukan oleh ADS_CHASE_REFERRALS_ENUM Enumerasi.
`ADS_OPTION_PAGE_SIZE` Mendapatkan atau mengatur nilai VT_I4 yang menunjukkan ukuran halaman dalam pencarian halaman.
`ADS_OPTION_SECURITY_MASK` Mendapatkan atau menetapkan nilai VT_I4 yang mengontrol data deskriptor keamanan yang dapat baca pada objek . Opsi ini dapat berisi kombinasi nilai apa pun yang ditentukan dalam ADS_SECURITY_INFO_ENUM enumerasi.
`ADS_OPTION_MUTUAL_AUTH_STATUS` Mendapatkan nilai VT_I4 yang menentukan apakah autentikasi bersama dilakukan oleh Lapisan SSPI. Jika nilai opsi yang dikembalikan berisi bendera ISC_RET_MUTUAL_AUTH , ditentukan dalam Sspi.h, maka autentikasi timbal balik telah dilakukan. Jika nilai opsi yang dikembalikan tidak berisi bendera ISC_RET_MUTUAL_AUTH , maka autentikasi timbal balik belum dilakukan. Untuk informasi selengkapnya tentang autentikasi timbal balik, lihat SSPI. Ini opsi tidak didukung oleh Metode IADsObjectOptions.SetOption .
`ADS_OPTION_QUOTA` Memungkinkan kuota yang efektif dan kuota yang digunakan dari prinsip keamanan untuk dibaca. Opsi ini mengambil VT_BSTR nilai yang berisi prinsip keamanan yang dapat dibaca oleh kuota. Jika string utama keamanan adalah panjang nol atau nilainya adalah nilai VT_EMPTY , prinsip keamanan adalah pengguna yang saat ini masuk. Opsi ini hanya didukung oleh Metode IADsObjectOptions.SetOption .
`ADS_OPTION_PASSWORD_PORTNUMBER` Mengambil atau menetapkan nilai VT_I4 yang berisi nomor port yang digunakan ADSI membuat koneksi ketika kata sandi diatur atau diubah. Secara default, ADSI menggunakan port 636 untuk membuat koneksi untuk mengatur atau mengubah kata sandi.
`ADS_OPTION_PASSWORD_METHOD` Mengambil atau menetapkan nilai VT_I4 yang menentukan metode pengodean kata sandi. Opsi ini dapat berisi salah satu nilai yang ditentukan dalam ADS_PASSWORD_ENCODING_ENUM Enumerasi.
`ADS_OPTION_ACCUMULATIVE_MODIFICATION` Berisi nilai VT_BOOL yang menentukan apakah operasi perubahan nilai atribut harus terakumulasi. Secara default, saat nilai atribut dimodifikasi lebih dari satu kali, nilai sebelumnya operasi perubahan ditimpa oleh operasi yang lebih baru. Jika opsi ini diatur ke VARIANT_TRUE, setiap operasi perubahan nilai atribut diakumulasikan dalam cache. Ketika pembaruan nilai atribut diterapkan ke server dengan Metode IADs.SetInfo , setiap individu terakumulasi operasi dikirim ke server. Ketika opsi ini telah diatur ke VARIANT_TRUE, opsi ini tidak dapat direset ke VARIANT_FALSE seumur hidup objek ADSI. Untuk mengatur ulang opsi ini, semua referensi ke objek ADSI harus dirilis dan objek harus terikat lagi. Ketika objek terikat ke lagi, opsi ini akan diatur ke VARIANT_FALSE secara default. Opsi ini hanya memengaruhi nilai atribut yang dimodifikasi dengan IADs.PutEx dan IADsPropertyList.PutPropertyItem Metode. Opsi ini diabaikan oleh metode IADs.Put .
`ADS_OPTION_SKIP_SID_LOOKUP` Jika opsi ini diatur pada objek, tidak ada pencarian yang akan dilakukan (baik selama pengambilan atau selama modifikasi). Opsi ini mempengaruhi IAD dan Antarmuka IADsPropertyList . Ini juga berlaku saat mengambil penggunaan kuota yang efektif dari pengguna tertentu.