DsIsNTDSOnline-Funktion
[Diese Funktion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie ab Windows Vista stattdessen den Volume Shadow Copy Service (VSS).
Die DsIsNTDSOnline-Funktion bestimmt, ob Active Directory Domain Services auf dem angegebenen Server online sind.
Syntax
HRESULT DsIsNTDSOnline(
_In_ LPCTSTR szServerName,
_Out_ BOOL *pfNTDSOnline
);
Parameter
-
szServerName [in]
-
Zeiger auf eine NULL-Zeichenfolge, die den Namen des zu testenden Servers enthält. Vorangehende umgekehrte Schrägstriche sind optional. Der Server muss derselbe Computer sein, von dem diese Funktion aufgerufen wird. Der Servername darf keine Unterstriche (_) enthalten. Ein Beispiel für einen Servernamen ist "\\server1".
-
pfNTDSOnline [out]
-
Zeiger auf den BOOL-Wert , der das Ergebnis empfängt. Empfängt TRUE , wenn der Verzeichnisdienst online ist, oder FALSE , wenn der Verzeichnisdienst offline ist.
Rückgabewert
Gibt S_OK zurück, wenn die Funktion erfolgreich ist oder andernfalls ein Fehlercode auftritt. Die folgende Liste listet mögliche Fehlercodes auf.
-
ERROR_ACCESS_DENIED
-
Der Aufrufer verfügt nicht über die erforderlichen Zugriffsberechtigungen zum Aufrufen dieser Funktion. Die DsSetAuthIdentity-Funktion kann verwendet werden, um die Anmeldeinformationen festzulegen, die für die Sicherungs- und Wiederherstellungsfunktionen verwendet werden sollen.
-
hrCouldNotConnect
-
Der Server in szServerName kann nicht gefunden werden, ist kein Domänencontroller oder szServerName ist nicht ordnungsgemäß formatiert. Dieser Wert wird in Ntdsbmsg.h definiert.
-
RPC_S_INVALID_BINDING
-
Die DsIsNTDSOnline-Funktion wird remote aufgerufen, oder der Server in szServerName ist kein Domänencontroller.
Bemerkungen
Rufen Sie diese Funktion auf, bevor Sie eine der Sicherungs- oder Wiederherstellungsfunktionen des Verzeichnisses aufrufen. Das Verzeichnis muss online sein, um eine Sicherung durchzuführen. Das Verzeichnis muss offline sein, um eine Wiederherstellung durchzuführen.
Diese Funktion kann nur von einem Domänencontroller aufgerufen werden, der auch der in szServerName angegebene Zielserver ist. Diese Funktion kann nicht remote aufgerufen werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Header |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
DsIsNTDSOnlineW (Unicode) und DsIsNTDSOnlineA (ANSI) |