Fungsi DsCrackUnquotedMangledRdnA (dsparse.h)

fungsi DsCrackUnquotedMangledRdn fungsi unmangles (tidak mengodekan) nama khusus relatif tertentu dan mengembalikan GUID yang didekode dan jenis mangling yang digunakan.

Sintaksis

DSPARSE BOOL DsCrackUnquotedMangledRdnA(
  [in]            LPCSTR        pszRDN,
  [in]            DWORD         cchRDN,
  [out, optional] GUID          *pGuid,
  [out, optional] DS_MANGLE_FOR *peDsMangleFor
);

Parameter

[in] pszRDN

Penunjuk ke string yang berisi nama khusus relatif (RDN) untuk diterjemahkan. Panjang string ini ditentukan oleh parameter cchRDN, sehingga string ini tidak diperlukan untuk dihentikan null. String ini harus dalam bentuk yang tidak dikutip. Untuk informasi selengkapnya tentang nama khusus relatif yang tidak dikutip, lihat DsUnquoteRdnValue.

[in] cchRDN

Berisi panjang, dalam karakter, dari string pszRDN .

[out, optional] pGuid

Penunjuk ke nilai GUID yang menerima GUID dari nama khusus relatif yang tidak dibedakan. Parameter ini dapat null.

[out, optional] peDsMangleFor

Penunjuk ke nilai DS_MANGLE_FOR yang menerima jenis mangling yang digunakan dalam nama pembeda relatif yang berantakan. Parameter ini dapat null.

Mengembalikan nilai

Fungsi ini mengembalikan TRUE jika nama yang dibedakan relatif adalah mangled atau FALSE sebaliknya. Jika fungsi ini mengembalikan FALSE, tidak pGuid atau peDsMangleFor menerima data apa pun.

Komentar

Fungsi ini mencoba mendekode (tidak membahayakan) RDN yang sebelumnya telah dihandel karena penghapusan atau konflik penamaan. Jika nama yang dibedakan relatif adalah mangled, fungsi mengembalikan TRUE dan mengambil jenis GUID dan mangle, jika diminta. Jika nama yang dibedakan relatif tidak terganggu, fungsi mengembalikan FALSE.

Nota

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

DS_MANGLE_FOR

Fungsi Pengendali Domain dan Manajemen Replikasi

DsIsMangledDn

DsIsMangledRdnValue

DsUnquoteRdnValue