Funzione DsIsNTDSOnline
[Questa funzione è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. A partire da Windows Vista, usare invece Il servizio copia shadow del volume (VSS).
La funzione DsIsNTDSOnline determina se Active Directory Domain Services sono online nel server specificato.
Sintassi
HRESULT DsIsNTDSOnline(
_In_ LPCTSTR szServerName,
_Out_ BOOL *pfNTDSOnline
);
Parametri
-
szServerName [in]
-
Puntatore a una stringa con terminazione null contenente il nome del server da testare. Le barre rovesciata precedenti sono facoltative. Il server deve essere lo stesso computer da cui viene chiamata questa funzione. Il nome del server non può contenere caratteri di sottolineatura (_). Un esempio di nome server è "\\server1".
-
pfNTDSOnline [out]
-
Puntatore al valore BOOL che riceve il risultato. Riceve TRUE se il servizio directory è online o FALSE se il servizio directory è offline.
Valore restituito
Restituisce S_OK se la funzione ha esito positivo o un codice di errore in caso contrario. Nell'elenco seguente sono elencati i codici di errore possibili.
-
ERROR_ACCESS_DENIED
-
Il chiamante non dispone dei privilegi di accesso appropriati per chiamare questa funzione. La funzione DsSetAuthIdentity può essere usata per impostare le credenziali da usare per le funzioni di backup e ripristino.
-
hrCouldNotConnect
-
Impossibile trovare il server in szServerName , non è un controller di dominio o szServerName non è formattato correttamente. Questo valore è definito in Ntdsbmsg.h.
-
RPC_S_INVALID_BINDING
-
La funzione DsIsNTDSOnline viene chiamata in remoto o il server in szServerName non è un controller di dominio.
Commenti
Chiamare questa funzione prima di chiamare una delle funzioni di backup o ripristino della directory. La directory deve essere online per eseguire un backup. La directory deve essere offline per eseguire un ripristino.
Questa funzione può essere chiamata solo da un controller di dominio che è anche il server di destinazione specificato in szServerName. Questa funzione non può essere chiamata in remoto.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Intestazione |
|
| Libreria |
|
| DLL |
|
| Nomi Unicode e ANSI |
DsIsNTDSOnlineW (Unicode) e DsIsNTDSOnlineA (ANSI) |