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.
HRESULT DsIsNTDSOnline(
_In_ LPCTSTR szServerName,
_Out_ BOOL *pfNTDSOnline
);
-
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.
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.
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.
Requisito | Valor |
---|---|
Cliente mínimo com suporte |
Windows Vista |
Servidor mínimo com suporte |
Windows Server 2008 |
Cabeçalho |
|
Biblioteca |
|
DLL |
|
Nomes Unicode e ANSI |
DsIsNTDSOnlineW (Unicode) e DsIsNTDSOnlineA (ANSI) |