Baca dalam bahasa Inggris

Bagikan melalui


Fungsi DsIsNTDSOnline

[Fungsi ini tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya. Dimulai dengan Windows Vista, gunakan Layanan Menyalin Bayangan Volume (VSS) sebagai gantinya.]

Fungsi DsIsNTDSOnline menentukan apakah Active Directory Domain Services online di server yang ditentukan.

Sintaks

HRESULT DsIsNTDSOnline(
  _In_  LPCTSTR szServerName,
  _Out_ BOOL    *pfNTDSOnline
);

Parameter

szServerName [in]

Penunjuk ke string yang dihentikan null yang berisi nama server untuk diuji. Garis miring terbalik sebelumnya bersifat opsional. Server harus merupakan komputer yang sama dengan asal fungsi ini. Nama server tidak boleh berisi karakter garis bawah (_). Contoh nama server adalah "\\server1".

pfNTDSOnline [out]

Pointer ke nilai BOOL yang menerima hasilnya. Menerima TRUE jika layanan direktori online atau FALSE jika layanan direktori offline.

Mengembalikan nilai

Mengembalikan S_OK jika fungsi berhasil atau kode kesalahan sebaliknya. Daftar berikut mencantumkan kemungkinan kode kesalahan.

ERROR_ACCESS_DENIED

Penelepon tidak memiliki hak akses yang tepat untuk memanggil fungsi ini. Fungsi DsSetAuthIdentity dapat digunakan untuk mengatur kredensial yang akan digunakan untuk fungsi pencadangan dan pemulihan.

hrCouldNotConnect

Server di szServerName tidak dapat ditemukan, bukan pengendali domain, atau szServerName tidak diformat dengan benar. Nilai ini didefinisikan dalam Ntdsbmsg.h.

RPC_S_INVALID_BINDING

Fungsi DsIsNTDSOnline sedang dipanggil dari jarak jauh atau server di szServerName bukan pengendali domain.

Keterangan

Panggil fungsi ini sebelum memanggil salah satu fungsi pencadangan atau pemulihan direktori. Direktori harus online untuk melakukan pencadangan. Direktori harus offline untuk melakukan pemulihan.

Fungsi ini hanya dapat dipanggil dari pengendali domain yang juga merupakan server target yang ditentukan dalam szServerName. Fungsi ini tidak dapat dipanggil dari jarak jauh.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
Windows Vista
Server minimum yang didukung
Windows Server 2008
Header
Ntdsbcli.h
Pustaka
Ntdsbcli.lib
DLL
Ntdsbcli.dll
Nama Unicode dan ANSI
DsIsNTDSOnlineW (Unicode) dan DsIsNTDSOnlineA (ANSI)

Lihat juga

DsSetAuthIdentity

Fungsi Pencadangan Direktori

Mencadangkan dan Memulihkan Server Direktori Aktif