Función DsIsNTDSOnline
[Esta función está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. A partir de Windows Vista, use el Servicio de instantáneas de volumen (VSS) en su lugar.
La función DsIsNTDSOnline determina si Servicios de dominio de Active Directory están en línea en el servidor especificado.
Sintaxis
HRESULT DsIsNTDSOnline(
_In_ LPCTSTR szServerName,
_Out_ BOOL *pfNTDSOnline
);
Parámetros
-
szServerName [in]
-
Puntero a una cadena terminada en null que contiene el nombre del servidor que se va a probar. Las barras diagonales inversas anteriores son opcionales. El servidor debe ser el mismo equipo desde el que se llama a esta función. El nombre del servidor no puede contener caracteres de subrayado (_). Un ejemplo de un nombre de servidor es "\\server1".
-
pfNTDSOnline [out]
-
Puntero al valor BOOL que recibe el resultado. Recibe TRUE si el servicio de directorio está en línea o FALSE si el servicio de directorio está sin conexión.
Valor devuelto
Devuelve S_OK si la función es correcta o un código de error de lo contrario. En la lista siguiente se enumeran los posibles códigos de error.
-
ERROR_ACCESS_DENIED
-
El autor de la llamada no tiene los privilegios de acceso adecuados para llamar a esta función. La función DsSetAuthIdentity se puede usar para establecer las credenciales que se usarán para las funciones de copia de seguridad y restauración.
-
hrCouldNotConnect
-
No se encuentra el servidor en szServerName , no es un controlador de dominio o szServerName no tiene el formato correcto. Este valor se define en Ntdsbmsg.h.
-
RPC_S_INVALID_BINDING
-
La función DsIsNTDSOnline se llama de forma remota o el servidor de szServerName no es un controlador de dominio.
Observaciones
Llame a esta función antes de llamar a cualquiera de las funciones de copia de seguridad o restauración del directorio. El directorio debe estar en línea para realizar una copia de seguridad. El directorio debe estar sin conexión para realizar una restauración.
Solo se puede llamar a esta función desde un controlador de dominio que también sea el servidor de destino especificado en szServerName. No se puede llamar a esta función de forma remota.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|
| Nombres Unicode y ANSI |
DsIsNTDSOnlineW (Unicode) y DsIsNTDSOnlineA (ANSI) |