Fungsi DsRemoveDsServerW (ntdsapi.h)

Fungsi DsRemoveDsServer menghapus semua jejak agen layanan direktori (DSA) dari area global layanan direktori.

Sintaksis

NTDSAPI DWORD DsRemoveDsServerW(
  [in]            HANDLE hDs,
  [in]            LPWSTR ServerDN,
  [in, optional]  LPWSTR DomainDN,
  [out, optional] BOOL   *fLastDcInDomain,
  [in]            BOOL   fCommit
);

Parameter

[in] hDs

Berisi handel layanan direktori yang diperoleh dari DSBind atau fungsi DSBindWithCred.

[in] ServerDN

Penunjuk ke string yang dihentikan null yang menentukan nama pengontrol domain yang sepenuhnya memenuhi syarat untuk dihapus.

[in, optional] DomainDN

Penunjuk ke string yang dihentikan null yang menentukan domain yang dihosting oleh ServerDN. Jika parameter ini NULL, tidak ada verifikasi yang dilakukan untuk memastikan bahwa ServerDN adalah pengontrol domain terakhir di DomainDN.

[out, optional] fLastDcInDomain

Penunjuk ke nilai Boolean yang menerima TRUE jika ServerDN adalah DC terakhir di DomainDN atau FALSE sebaliknya. Parameter ini menerima FALSE jika DomainDN NULL.

[in] fCommit

Berisi nilai Boolean yang menentukan apakah pengendali domain harus benar-benar dihapus. Jika parameter ini bukan nol, ServerDN dihapus. Jika parameter ini nol, keberadaan ServerDN diperiksa dan fLastDcInDomain ditulis, tetapi pengendali domain tidak dihapus.

Mengembalikan nilai

Mengembalikan ERROR_SUCCESS jika berhasil atau kode kesalahan Win32 atau RPC jika tidak berhasil. Kemungkinan kode kesalahan termasuk yang berikut ini.

Komentar

Nota

Header ntdsapi.h mendefinisikan DsRemoveDsServer sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprocessor 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	ntdsapi.h
Pustaka	Ntdsapi.lib
DLL	Ntdsapi.dll

Lihat juga

Fungsi Pengendali Domain dan Manajemen Replikasi

DsBind

DsBindWithCred

DsRemoveDsDomain