Função DsReplicaDelA (ntdsapi.h)
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 |
Confira também
Funções de gerenciamento de replicação e controlador de domínio