Fungsi DsQuoteRdnValueA (dsparse.h)

Fungsi DsQuoteRdnValue mengonversi RDN menjadi nilai RDN yang dikutip, jika nilai RDN berisi karakter yang memerlukan tanda kutip. RDN yang dikutip kemudian dapat dikirimkan sebagai bagian dari nama khusus (DN) ke layanan direktori menggunakan berbagai API seperti LDAP. Contoh RDN yang memerlukan tanda kutip akan menjadi salah satu yang memiliki nilai yang dipisahkan koma, seperti RDN untuk nama yang menggunakan format "last,first".

Sintaksis

DSPARSE DWORD DsQuoteRdnValueA(
  [in]      DWORD cUnquotedRdnValueLength,
  [in]      LPCCH psUnquotedRdnValue,
  [in, out] DWORD *pcQuotedRdnValueLength,
  [out]     LPCH  psQuotedRdnValue
);

Parameter

[in] cUnquotedRdnValueLength

Jumlah karakter dalam string psUnquotedRdnValue .

[in] psUnquotedRdnValue

String yang menentukan nilai RDN yang tidak dikutip.

[in, out] pcQuotedRdnValueLength

Jumlah maksimum karakter dalam string psQuotedRdnValue .

Bendera berikut adalah output untuk parameter ini.

ERROR_SUCCESS

Menunjukkan bahwa jumlah karakter yang benar ditemukan di psQuotedRdnValue.

ERROR_BUFFER_OVERFLOW

Menunjukkan bahwa jumlah karakter dalam string tidak cocok dengan psQuotedRdnValue.

[out] psQuotedRdnValue

String yang menerima nilai RDN yang dikonversi, dan mungkin dikutip.

Mengembalikan nilai

Daftar berikut berisi kemungkinan nilai yang dikembalikan untuk fungsi DsQuoteRdnValue.

Komentar

Kuotasi tidak ditambahkan ke RDN jika tidak ada yang diperlukan. Dalam hal ini, nilai RDN output sama dengan nilai RDN input.

Ketika mengutip diperlukan, RDN dikutip sesuai dengan spesifikasi "Lightweight Directory Access Protocol (v3): Representasi String UTF-8 dari Nama Khusus," RFC 2253.

Nilai RDN input dan output tidak nullstring yang dihentikan.

Untuk mengembalikan perubahan yang dilakukan oleh panggilan ini, panggil fungsi DsUnquoteRdnValue.

Nota

Header dsparse.h mendefinisikan DsQuoteRdnValue sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista
server minimum yang didukung	Windows Server 2008
Platform Target	Windows
Header	dsparse.h (termasuk Ntdsapi.h)
Pustaka	Ntdsapi.lib
DLL	Ntdsapi.dll

Lihat juga

Fungsi Pengendali Domain dan Manajemen Replikasi

DsUnquoteRdnValue