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.
HRESULT DsIsNTDSOnline(
_In_ LPCTSTR szServerName,
_Out_ BOOL *pfNTDSOnline
);
-
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 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.
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 | Nilai |
---|---|
Klien minimum yang didukung |
Windows Vista |
Server minimum yang didukung |
Windows Server 2008 |
Header |
|
Pustaka |
|
DLL |
|
Nama Unicode dan ANSI |
DsIsNTDSOnlineW (Unicode) dan DsIsNTDSOnlineA (ANSI) |