Fungsi DsGetRdnW (dsparse.h)

Fungsi DsGetRdnW mengambil kunci dan nilai nama pembeda relatif pertama dan penunjuk ke nama yang dibedakan relatif berikutnya dari string nama yang dibedakan.

Sintaks

DSPARSE DWORD DsGetRdnW(
  [in, out] LPCWCH *ppDN,
  [in, out] DWORD  *pcDN,
  [out]     LPCWCH *ppKey,
  [out]     DWORD  *pcKey,
  [out]     LPCWCH *ppVal,
  [out]     DWORD  *pcVal
);

Parameter

[in, out] ppDN

Alamat penunjuk string Unicode yang, pada entri, berisi string nama khusus yang akan diurai. Panjang string ini ditentukan dalam parameter pcDN . Jika fungsi berhasil, parameter ini disesuaikan untuk menunjuk ke sisa nama khusus yang eksklusif dari nama khusus relatif saat ini. Misalnya, jika parameter ini menunjuk ke string "dc=corp,dc=fabrikam,dc=com", setelah fungsi selesai parameter ini menunjuk ke string ",dc=fabrikam,dc=com".

[in, out] pcDN

Penunjuk ke nilai DWORD yang, pada entri, berisi jumlah karakter dalam string ppDN . Jika fungsi berhasil, parameter ini menerima jumlah karakter di sisa nama khusus. Nilai-nilai ini tidak menyertakan karakter yang dihentikan null.

[out] ppKey

Penunjuk ke nilai LPCWCH yang, jika fungsi berhasil, menerima penunjuk ke kunci dalam string nama yang dibedakan relatif. Penunjuk ini berada dalam string ppDN dan tidak dihentikan null. Parameter pcKey menerima jumlah karakter dalam kunci. Parameter ini tidak terdefinisi jika pcKey menerima nol.

[out] pcKey

Penunjuk ke nilai DWORD yang, jika fungsi berhasil, menerima jumlah karakter dalam string kunci yang diwakili oleh parameter ppKey . Jika parameter ini menerima nol, ppKey tidak terdefinisi.

[out] ppVal

Penunjuk ke nilai LPCWCH yang, jika fungsi berhasil, menerima penunjuk ke nilai dalam string nama yang dibedakan relatif. Penunjuk ini berada dalam string ppDN dan tidak dihentikan null. Parameter pcVal menerima jumlah karakter dalam nilai . Parameter ini tidak terdefinisi jika pcVal menerima nol.

[out] pcVal

Penunjuk ke nilai DWORD yang, jika fungsi berhasil, menerima jumlah karakter dalam string nilai yang diwakili oleh parameter ppVal . Jika parameter ini menerima nol, ppVal tidak terdefinisi.

Menampilkan nilai

Mengembalikan ERROR_SUCCESS jika berhasil atau kode kesalahan Win32 sebaliknya. Kode kesalahan yang mungkin mencakup nilai berikut.

Persyaratan

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

Lihat juga

Fungsi Pengendali Domain dan Manajemen Replikasi