Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
[Ta funkcja jest dostępna do użytku w systemach operacyjnych określonych w sekcji Wymagania. Może zostać zmieniony lub niedostępny w kolejnych wersjach. Począwszy od systemu Windows Vista, użyj usługi kopiowania woluminów w tle (VSS) zamiast.]
Funkcja DsIsNTDSOnline określa, czy usługi domenowe w usłudze Active Directory są w trybie online na określonym serwerze.
Składnia
HRESULT DsIsNTDSOnline(
_In_ LPCTSTR szServerName,
_Out_ BOOL *pfNTDSOnline
);
Parametry
szNazwaSerwera[in]
Wskaźnik do ciągu zakończonego wartością null, który zawiera nazwę serwera do przetestowania. Poprzedzające ukośniki odwrotne są opcjonalne. Serwer musi być tym samym komputerem, z którego jest wywoływana ta funkcja. Nazwa serwera nie może zawierać żadnych znaków podkreślenia (_). Przykładem nazwy serwera jest "\\serwer1".
pfNTDSOnline[out]
Wskaźnik do wartości BOOL , która odbiera wynik. Odbiera wartość TRUE , jeśli usługa katalogowa jest w trybie online, lub FALSE , jeśli usługa katalogowa jest w trybie offline.
Wartość zwracana
Zwraca S_OK , jeśli funkcja zakończy się powodzeniem lub kod błędu w przeciwnym razie. Poniższa lista zawiera listę możliwych kodów błędów.
BŁĄD_ODMOWA_DOSTĘPU
Osoba wywołująca nie ma odpowiednich uprawnień dostępu do wywołania tej funkcji. Funkcja DsSetAuthIdentity może służyć do ustawiania poświadczeń, które mają być używane dla funkcji tworzenia kopii zapasowych i przywracania.
hrCouldNotConnect
Nie można odnaleźć serwera w polu szServerName , nie jest on kontrolerem domeny lub parametr szServerName nie jest poprawnie sformatowany. Ta wartość jest zdefiniowana w pliku Ntdsbmsg.h.
RPC_S_INVALID_BINDING
Funkcja DsIsNTDSOnline jest wywoływana zdalnie lub serwer w elemencie szServerName nie jest kontrolerem domeny.
Uwagi
Wywołaj tę funkcję przed wywołaniem którejkolwiek z funkcji tworzenia kopii zapasowej lub przywracania katalogu. Katalog musi być w trybie online, aby można było wykonać kopię zapasową. Katalog musi być w trybie offline, aby można było go przywrócić.
Tę funkcję można wywołać tylko z kontrolera domeny, który jest również serwerem docelowym określonym w parametrze szServerName. Tej funkcji nie można wywołać zdalnie.
Wymagania
| Wymaganie | Wartość |
|---|---|
| Minimalny obsługiwany klient | Windows Vista |
| Minimalny obsługiwany serwer | Windows Server 2008 |
| Nagłówek | Ntdsbcli.h |
| Biblioteka | Ntdsbcli.lib |
| DLL | Ntdsbcli.dll |
| Nazwy Unicode i ANSI | DsIsNTDSOnlineW (Unicode) i DsIsNTDSOnlineA (ANSI) |
Zobacz także
Funkcje kopii zapasowej katalogu
Tworzenie kopii zapasowej i przywracanie serwera usługi Active Directory