Función DsIsNTDSOnline

[Esta función está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores. A partir de Windows Vista, use servicio de instantáneas de volumen (VSS) en su lugar.

La función DsIsNTDSOnline determina si los 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 invertidas 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 se realiza correctamente o si un código de error en caso contrario. En la siguiente lista 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 puede encontrar el servidor de 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 de directorios. 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.

Esta función solo se puede llamar desde un controlador de dominio que también sea el servidor de destino especificado en szServerName. Esta función no se puede llamar de forma remota.

Requisitos

Requisito	Importancia
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Cabecera	Ntdsbcli.h
Biblioteca	Ntdsbcli.lib
DLL	Ntdsbcli.dll
Nombres Unicode y ANSI	DsIsNTDSOnlineW (Unicode) y DsIsNTDSOnlineA (ANSI)

Consulte también

DsSetAuthIdentity

de funciones de copia de seguridad de directorio de

Copia de seguridad y restauración de un servidor de Active Directory