Função DsRemoveDsServerA (ntdsapi.h)

A função DsRemoveDsServer remove todos os rastreamentos de um agente de serviço de diretório (DSA) da área global do serviço de diretório.

Sintaxe

NTDSAPI DWORD DsRemoveDsServerA(
  [in]            HANDLE hDs,
  [in]            LPSTR  ServerDN,
  [in, optional]  LPSTR  DomainDN,
  [out, optional] BOOL   *fLastDcInDomain,
  [in]            BOOL   fCommit
);

Parâmetros

[in] hDs

Contém um identificador de serviço de diretório obtido da função DSBind ou DSBindWithCred .

[in] ServerDN

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome diferenciado totalmente qualificado do controlador de domínio a ser removido.

[in, optional] DomainDN

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica um domínio hospedado pelo ServerDN. Se esse parâmetro for NULL, nenhuma verificação será executada para garantir que ServerDN seja o último controlador de domínio no DomainDN.

[out, optional] fLastDcInDomain

Ponteiro para um valor booliano que receberá TRUE se ServerDN for o último DC no DomainDN ou FALSE caso contrário. Esse parâmetro receberá FALSE se DomainDN for NULL.

[in] fCommit

Contém um valor booliano que especifica se o controlador de domínio deve realmente ser removido. Se esse parâmetro for diferente de zero, ServerDN será removido. Se esse parâmetro for zero, a existência de ServerDN será verificada e fLastDcInDomain será gravada, mas o controlador de domínio não será removido.

Retornar valor

Retorna ERROR_SUCCESS se tiver êxito ou um código de erro Win32 ou RPC, se não for bem-sucedido. Os códigos de erro possíveis incluem o seguinte.

Comentários

Observação

O cabeçalho ntdsapi.h define DsRemoveDsServer como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	ntdsapi.h
Biblioteca	Ntdsapi.lib
DLL	Ntdsapi.dll

Confira também

Funções de gerenciamento de replicação e controlador de domínio

DsBind

DsBindWithCred

DsRemoveDsDomain