Função DsRemoveDsServerA (ntdsapi.h)

Artigo
11/20/2024

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 por 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 recebe TRUE se ServerDN for o último DC em DomainDN ou FALSE caso contrário. Esse parâmetro receberá FALSE se DomainDN estiver NULL.

[in] fCommit

Contém um valor booliano que especifica se o controlador de domínio deve realmente ser removido. Se esse parâmetro não for 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.

Valor de retorno

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

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
servidor com suporte mínimo	Windows Server 2008
da Plataforma de Destino	Windows
cabeçalho	ntdsapi.h
biblioteca	Ntdsapi.lib
de DLL	Ntdsapi.dll

Consulte também

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

DsBind

DsBindWithCred

DsRemoveDsDomain

Compartilhar via