DsIsNTDSOnline-Funktion

[Diese Funktion steht für die Verwendung in den Betriebssystemen zur Verfügung, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. Verwenden Sie ab Windows Vista stattdessen Volume Shadow Copy Service (VSS).]

Die DsIsNTDSOnline-Funktion bestimmt, ob Active Directory-Domänendienste auf dem angegebenen Server online sind.

Syntax

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

Die Parameter

szServerName[in]

Zeiger auf eine auf NULL terminierte Zeichenfolge, die den Namen des zu testenden Servers enthält. Vorangestellte umgekehrte Schrägstriche sind optional. Bei dem Server muss es sich um denselben Computer handeln, von dem aus diese Funktion aufgerufen wird. Der Servername darf keinen Unterstrich (_) enthalten. Ein Beispiel für einen Servernamen ist "\\server1".

pfNTDSOnline[out]

Zeiger auf den BOOL-Wert , der das Ergebnis empfängt. Erhält TRUE , wenn der Verzeichnisdienst online ist, oder FALSE , wenn der Verzeichnisdienst offline ist.

Rückgabewert

Gibt S_OK zurück, ob die Funktion erfolgreich ist, oder andernfalls einen Fehlercode. In der folgenden Liste sind mögliche Fehlercodes aufgeführt.

ERROR_ACCESS_DENIED

Der Aufrufer verfügt nicht über die richtigen Zugriffsrechte, um diese Funktion aufzurufen. 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, es handelt sich nicht um einen Domänencontroller, oder szServerName ist nicht ordnungsgemäß formatiert. Dieser Wert wird in Ntdsbmsg.h definiert.

RPC_S_INVALID_BINDING

Die Funktion DsIsNTDSOnline wird remote aufgerufen, oder der Server in szServerName ist kein Domänencontroller.

Bemerkungen

Rufen Sie diese Funktion auf, bevor Sie eine der Funktionen zum Sichern oder Wiederherstellen des Verzeichnisses aufrufen. Das Verzeichnis muss online sein, um eine Sicherung durchführen zu können. Das Verzeichnis muss offline sein, um eine Wiederherstellung durchführen zu können.

Diese Funktion kann nur von einem Domänencontroller aufgerufen werden, der auch der in szServerName angegebene Zielserver ist. Diese Funktion kann nicht aus der Ferne aufgerufen werden.

Anforderungen

Siehe auch

DsSetAuthIdentity

Verzeichnissicherungsfunktionen

Sichern und Wiederherstellen eines Active Directory-Servers