Função DsIsNTDSOnline

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

A função DsIsNTDSOnline determina se os Serviços de Domínio Active Directory 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 sublinhado (_). Um exemplo de nome de servidor é "\\server1".

pfNTDSOnline[out]

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

Valor de retorno

Retorna S_OK se a função for bem-sucedida ou um código de erro caso contrário. A lista a seguir lista 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.

Observações

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 ficar offline para executar uma restauração.

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

Requisitos

Consulte também

DsSetAuthIdentity

Funções de backup do diretório

Fazendo backup e restaurando um servidor do Active Directory