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	Ntdsbcli.h
Bibliothek	Ntdsbcli.lib
DLL	Ntdsbcli.dll
Unicode- und ANSI-Name	DsIsNTDSOnlineW (Unicode) und DsIsNTDSOnlineA (ANSI)

Siehe auch

DsSetAuthIdentity

Verzeichnissicherungsfunktionen

Sichern und Wiederherstellen eines Active Directory-Servers