enumerasi ADS_ESCAPE_MODE_ENUM (iads.h)

Artikel
02/28/2024

Enumerasi ADS_ESCAPE_MODE_ENUM menentukan bagaimana karakter escape ditampilkan di jalur direktori.

Sintaks

typedef enum __MIDL___MIDL_itf_ads_0001_0078_0004 {
  ADS_ESCAPEDMODE_DEFAULT = 1,
  ADS_ESCAPEDMODE_ON = 2,
  ADS_ESCAPEDMODE_OFF = 3,
  ADS_ESCAPEDMODE_OFF_EX = 4
} ADS_ESCAPE_MODE_ENUM;

Konstanta

ADS_ESCAPEDMODE_DEFAULT
Nilai: 1
Mode escape default menyediakan opsi yang nyaman untuk menentukan mode escape. Ini memiliki efek operasi escape minimal yang sesuai untuk format yang dipilih. Dengan demikian, perilaku default tergantung pada nilai yang ADS_FORMAT_ENUM gunakan untuk mengambil jalur direktori.

Format jalur yang diambil	Mode escape default
ADS_FORMAT_X500	ADS_ESCAPEDMODE_ON
ADS_FORMAT_X500_NO_SERVER	ADS_ESCAPEDMODE_ON
ADS_FORMAT_WINDOWS	ADS_ESCAPEDMODE_ON
ADS_FORMAT_WINDOWS_NO_SERVER	ADS_ESCAPEDMODE_ON
ADS_FORMAT_X500_DN	ADS_ESCAPEDMODE_OFF
ADS_FORMAT_X500_PARENT	ADS_ESCAPEDMODE_OFF
ADS_FORMAT_WINDOWS_DN	ADS_ESCAPEDMODE_OFF
ADS_FORMAT_WINDOWS_PARENT	ADS_ESCAPEDMODE_OFF
ADS_FORMAT_LEAF	ADS_ESCAPEDMODE_ON

ADS_ESCAPEDMODE_ON
Nilai: 2
Semua karakter khusus ditampilkan dalam format escape; misalnya, "CN=date=yy/mm/dd,weekday" muncul apa adanya.

ADS_ESCAPEDMODE_OFF
Nilai: 3
Karakter khusus ADSI ditampilkan dalam format yang tidak dilewati; misalnya, "CN=date=yy/mm/dd,weekday" muncul sebagai "CN=date=yy/mm/dd,weekday".

ADS_ESCAPEDMODE_OFF_EX
Nilai: 4
Karakter khusus ADSI dan LDAP ditampilkan dalam format yang tidak dilewati; misalnya, "CN=date=yy/mm/dd,weekday" muncul sebagai "CN=date=yy/mm/dd,weekday".

Keterangan

Karakter khusus harus diloloskan ketika digunakan untuk tujuan yang tidak diinginkan. Misalnya, karakter khusus LDAP, koma (,) dan tanda sama dengan (=), dimaksudkan sebagai pemisah bidang dalam nama khusus, "CN=user,CN=users,DC=Fabrikam,DC=com". Ketika nilai atribut menggunakan karakter khusus tersebut, misalnya, "CN=users,last name=Smith", karakter khusus ini harus diloloskan seperti yang ditunjukkan. Ini memastikan bahwa direktori yang mematuhi LDAP, seperti Direktori Aktif, akan mengurai jalur dengan benar. Namun, string jalur yang lolos mungkin tidak tampak ramah pengguna pada tampilan. Dalam hal ini, Anda dapat mengatur ADS_ESCAPE_MODE_ENUM dengan cara seperti itu yang menunjukkan jalur sebagai string yang tidak dilewati, "CN=users,last name=Smith".

Demikian pula, karakter khusus ADSI, tanda garis miring (/), memisahkan elemen khusus ADSI, "LDAP://server/CN=Jeff Smith,CN=Users,DC=Fabrikam,DC=com". Meskipun harus lolos ketika digunakan untuk tujuan lain, misalnya, "LDAP://server/CN=Jeff Smith/California,CN=Users,DC=Fabrikam,DC=com". Anda dapat memilih opsi ADS_ESCAPE_MODE_ENUM untuk menampilkan string escaped ini dalam bentuk yang dapat dibaca manusia: "LDAP://server/CN=Jeff Smith/California,CN=Users,DC=Fabrikam,DC=com".

Saat ini, tanda garis miring (/) adalah satu-satunya karakter khusus ADSI. AdsI melarikan diri dan unescaping hanya berlaku untuk karakter khusus ADSI. Operasi ini tidak akan memengaruhi karakter khusus LDAP apa pun, yaitu, mereka tidak lolos atau tidak terlewati. Untuk informasi selengkapnya dan daftar karakter khusus yang ditentukan oleh LDAP, lihat Karakter Khusus LDAP.

Untuk menampilkan string jalur yang tidak dilewati, gunakan antarmuka IADsPathname dan metodenya. Semua API ADSI lainnya mengembalikan string jalur yang lolos.

Untuk mendapatkan perilaku yang benar, karakter khusus LDAP harus dilewati sebelum karakter khusus ADSI lolos. Antarmuka IADsPathname akan lolos dari karakter dalam urutan yang benar.

Catatan Karena VBScript tidak dapat membaca data dari pustaka jenis, aplikasi Visual Basic Scripting Edition (VBScript) tidak mengenali simbolis, seperti konstanta yang ditentukan di atas. Sebagai gantinya, gunakan konstanta numerik sebagai gantinya untuk mengatur bendera yang sesuai di aplikasi VBScript Anda. Untuk menggunakan konstanta simbolis, tulis deklarasi eksplisit dari konstanta tersebut, seperti yang dilakukan di sini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Header	iads.h

Lihat juga

Bagikan melalui