Bagikan melalui

Fungsi DsUnquoteRdnValueA (dsparse.h)

Fungsi DsUnquoteRdnValue adalah panggilan klien yang mengonversi nilai RDN yang dikutip kembali ke nilai RDN yang tidak dikutip. Karena RDN awalnya dimasukkan ke dalam tanda kutip karena berisi karakter yang dapat disalahartikan ketika disematkan dalam nama khusus (DN), nilai RDN yang tidak dikutip tidak boleh dikirimkan sebagai bagian dari DN ke layanan direktori menggunakan berbagai API seperti LDAP.

Sintaksis

DSPARSE DWORD DsUnquoteRdnValueA(
  [in]      DWORD cQuotedRdnValueLength,
  [in]      LPCCH psQuotedRdnValue,
  [in, out] DWORD *pcUnquotedRdnValueLength,
  [out]     LPCH  psUnquotedRdnValue
);

Parameter

[in] cQuotedRdnValueLength

Jumlah karakter dalam string psQuotedRdnValue.

[in] psQuotedRdnValue

Nilai RDN yang mungkin dikutip dan lolos.

[in, out] pcUnquotedRdnValueLength

Nilai input untuk argumen ini adalah panjang maksimum, dalam karakter, dari psQuotedRdnValue.

Nilai output untuk argumen ini mencakup bendera berikut.

ERROR_SUCCESS

Ini dikembalikan jika jumlah karakter cocok dengan string yang digunakan dalam psQuotedRdnValue.

ERROR_BUFFER_OVERFLOW

Ini dikembalikan jika jumlah karakter tidak cocok dengan string yang digunakan dalam psQuotedRdnValue.

[out] psUnquotedRdnValue

Nilai RDN yang dikonversi dan tidak dikutip.

Mengembalikan nilai

Daftar berikut berisi kemungkinan nilai yang dikembalikan untuk fungsi DsUnquoteRdnValue.

Komentar

Ketika psQuotedRdnValue dikutip:

  • Tanda kutip awal dan akhir dihapus.
  • Spasi kosong sebelum kutipan pertama dibuang.
  • Spasi kosong di belakang kutipan terakhir dibuang.
  • Escape dihapus dan karakter setelah escape disimpan.
Tindakan berikut diambil ketika psQuotedRdnValue tidak dikutip:
  • Ruang putih di depan dibuang.
  • Ruang putih berikutnya disimpan.
  • Karakter non-khusus yang lolos mengembalikan kesalahan.
  • Karakter khusus yang tidak dilewati mengembalikan kesalahan.
  • Nilai RDN yang dimulai dengan # (mengabaikan spasi putih terkemuka) ditangani sebagai nilai BER yang sebelumnya telah dikonversi menjadi string, dan dikonversi sesuai.
  • Digit heksa yang lolos (\89) dikonversi menjadi byte biner (0x89).
  • Escape dihapus dari karakter khusus yang lolos.
Tindakan berikut selalu diambil:
  • Karakter khusus yang lolos tidak dilewati.
  • Nilai RDN input dan output bukan nilai null-terminated.

Nota

Header dsparse.h mendefinisikan DsUnquoteRdnValue 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

DsQuoteRdnValue

  • Last updated on