Fonction DsIsNTDSOnline
[Cette fonction est disponible pour une utilisation 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 plutôt le service VSS (Volume Shadow Copy Service ).
La fonction DsIsNTDSOnline détermine si services de domaine Active Directory sont en ligne sur le serveur spécifié.
Syntaxe
HRESULT DsIsNTDSOnline(
_In_ LPCTSTR szServerName,
_Out_ BOOL *pfNTDSOnline
);
Paramètres
-
szServerName [in]
-
Pointeur vers une chaîne terminée par null qui contient le nom du serveur à tester. Les barres obliques inverses précédentes sont facultatives. Le serveur doit être le même ordinateur à partir duquel cette fonction est appelée. Le nom du serveur ne peut pas contenir de caractères de soulignement (_). Un exemple de nom de serveur est « \\server1 ».
-
pfNTDSOnline [out]
-
Pointeur vers la valeur BOOL qui reçoit le résultat. Reçoit 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 si un code d’erreur est contraire. La liste suivante répertorie les codes d’erreur possibles.
-
ERROR_ACCESS_DENIED
-
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.
-
RPC_S_INVALID_BINDING
-
La fonction DsIsNTDSOnline est appelée à distance ou le serveur dans szServerName n’est pas un contrôleur de domaine.
Notes
Appelez cette fonction avant d’appeler l’une des fonctions de sauvegarde ou de restauration du répertoire. Le répertoire doit être en ligne pour effectuer une sauvegarde. Le répertoire doit être 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.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| En-tête |
|
| Bibliothèque |
|
| DLL |
|
| Noms Unicode et ANSI |
DsIsNTDSOnlineW (Unicode) et DsIsNTDSOnlineA (ANSI) |