Função DsReplicaDelA (ntdsapi.h)

Artigo
03/05/2024

A função DsReplicaDel remove uma referência de origem de replicação de um contexto de nomenclatura de destino (NC).

Sintaxe

NTDSAPI DWORD DsReplicaDelA(
  [in] HANDLE hDS,
  [in] LPCSTR NameContext,
  [in] LPCSTR DsaSrc,
  [in] ULONG  Options
);

Parâmetros

[in] hDS

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

[in] NameContext

Ponteiro para uma cadeia de caracteres terminada em nulo constante que especifica o DN (nome diferenciado) do NC de destino do qual remover o réplica. O registro NC de destino deve existir localmente como um objeto, instanciado ou não, ou um fantasma de referência, por exemplo, um fantasma com um GUID.

[in] DsaSrc

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo constante que especifica o endereço específico do transporte do DSA (agente do sistema de diretório de origem). Esse servidor de origem é identificado por um nome de cadeia de caracteres, não por sua UUID. Um nome de cadeia de caracteres apropriado para DsaSrc geralmente é um nome DNS baseado em um GUID, em que a parte GUID do nome é o GUID do objeto nTDSDSA para o servidor de origem.

[in] Options

Passa dados adicionais usados para processar a solicitação. Esse parâmetro pode ser uma combinação dos seguintes valores.

DS_REPDEL_ASYNCHRONOUS_OPERATION

Executa essa operação de forma assíncrona.

DS_REPDEL_IGNORE_ERRORS

Ignora qualquer erro gerado ao contatar a origem para instruí-la a remover esse NC de sua lista de servidores aos quais ele replica.

DS_REPDEL_INTERSITE_MESSAGING

Significa que o réplica é baseado em email em vez de sincronizado usando o RPC do serviço de diretório nativo.

DS_REPDEL_LOCAL_ONLY

Não entra em contato com a origem para dizer a ele para remover esse NC de sua lista de servidores aos quais ele replica. Se esse sinalizador não estiver definido e o link for baseado em RPC, a origem será contatada.

DS_REPDEL_NO_SOURCE

Exclui todos os objetos no NC. Essa opção é válida apenas para NCs somente leitura sem origem.

DS_REPDEL_REF_OK

Permite a exclusão de um réplica somente leitura, mesmo que ele forneça outras réplicas somente leitura.

DS_REPDEL_WRITEABLE

Significa que o réplica excluído pode ser gravado.

Retornar valor

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado será um erro de API Win32 padrão ou ERROR_INVALID_PARAMETER se um parâmetro for inválido.

Comentários

Observação

O cabeçalho ntdsapi.h define DsReplicaDel 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