DsIsNTDSOnline fonction)

[Cette fonction peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. à partir de Windows Vista, utilisez Service VSS (VSS) à la place.]

La fonction DsIsNTDSOnline détermine si Active Directory Domain Services sont en ligne sur le serveur spécifié.

Syntaxe

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

Paramètres

szServerName [ dans]

Pointeur vers une chaîne se terminant par un caractère null qui contient le nom du serveur à tester. Les barres obliques inverses précédentes sont facultatives. Le serveur doit être le même que celui à partir duquel cette fonction est appelée. Le nom du serveur ne peut pas contenir de caractères de soulignement ( _ ). Exemple de nom de serveur \ \ : « serveur1 ».

pfNTDSOnline [ à]

Pointeur vers une valeur bool qui reçoit le résultat. Reçoit la valeur true si le service d’annuaire est en ligne ou false si le service d’annuaire est hors connexion.

Valeur retournée

Retourne S _ OK si la fonction réussit ou un code d’erreur dans le cas contraire. La liste suivante répertorie les codes d’erreur possibles.

ERREUR d' _ accès _ refusé

L’appelant ne dispose pas des privilèges d’accès appropriés pour appeler cette fonction. La fonction DsSetAuthIdentity peut être utilisée pour définir les informations d’identification à utiliser pour les fonctions de sauvegarde et de restauration.

hrCouldNotConnect

Le serveur dans szServerName est introuvable, n’est pas un contrôleur de domaine ou szServerName n’est pas mis en forme correctement. Cette valeur est définie dans ntdsbmsg. h.

_liaison RPC S _ non valide _

La fonction DsIsNTDSOnline est appelée à distance ou le serveur dans szServerName n’est pas un contrôleur de domaine.

Remarques

Appelez cette fonction avant d’appeler l’une des fonctions de sauvegarde ou de restauration de répertoire. Le répertoire doit être en ligne pour pouvoir effectuer une sauvegarde. Le répertoire doit être en mode hors connexion pour effectuer une restauration.

Cette fonction ne peut être appelée qu’à partir d’un contrôleur de domaine qui est également le serveur cible spécifié dans szServerName. Cette fonction ne peut pas être appelée à distance.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
En-tête
Ntdsbcli. h
Bibliothèque
Ntdsbcli. lib
DLL
Ntdsbcli.dll
Noms Unicode et ANSI
DsIsNTDSOnlineW (Unicode) et DsIsNTDSOnlineA (ANSI)

Voir aussi

DsSetAuthIdentity

Fonctions de sauvegarde d’annuaire

Sauvegarde et restauration d’un serveur Active Directory