Função DsIsNTDSOnline

[Essa função está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. A partir do Windows Vista, use o VSS (Serviço de Cópia de Sombra de Volume).

A função DsIsNTDSOnline determina se Active Directory Domain Services estão online no servidor especificado.

Sintaxe

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

Parâmetros

szServerName [in]

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do servidor a ser testado. As barras invertidas anteriores são opcionais. O servidor deve ser o mesmo computador do qual essa função é chamada. O nome do servidor não pode conter nenhum caractere de sublinhado (_). Um exemplo de nome de servidor é "\\server1".

pfNTDSOnline [out]

Ponteiro para o valor BOOL que recebe o resultado. Receberá TRUE se o serviço de diretório estiver online ou FALSE se o serviço de diretório estiver offline.

Valor retornado

Retornará S_OK se a função for bem-sucedida ou um código de erro, caso contrário. A lista a seguir lista os possíveis códigos de erro.

ERROR_ACCESS_DENIED

O chamador não tem os privilégios de acesso adequados para chamar essa função. A função DsSetAuthIdentity pode ser usada para definir as credenciais a serem usadas para as funções de backup e restauração.

hrCouldNotConnect

O servidor em szServerName não pode ser encontrado, não é um controlador de domínio ou szServerName não está formatado corretamente. Esse valor é definido em Ntdsbmsg.h.

RPC_S_INVALID_BINDING

A função DsIsNTDSOnline está sendo chamada remotamente ou o servidor em szServerName não é um controlador de domínio.

Comentários

Chame essa função antes de chamar qualquer uma das funções de backup ou restauração do diretório. O diretório deve estar online para executar um backup. O diretório deve estar offline para executar uma restauração.

Essa função só pode ser chamada de um controlador de domínio que também é o servidor de destino especificado em szServerName. Essa função não pode ser chamada remotamente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Cabeçalho	Ntdsbcli.h
Biblioteca	Ntdsbcli.lib
DLL	Ntdsbcli.dll
Nomes Unicode e ANSI	DsIsNTDSOnlineW (Unicode) e DsIsNTDSOnlineA (ANSI)

Confira também

DsSetAuthIdentity

Funções de backup de diretório

Fazendo backup e restaurando um servidor do Active Directory