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 a 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 seu UUID. Um nome de cadeia de caracteres apropriado para
[in] Options
Passa dados adicionais usados para processar a solicitação. Esse parâmetro pode ser uma combinação dos valores a seguir.
DS_REPDEL_ASYNCHRONOUS_OPERATION
Executa essa operação de forma assíncrona.
DS_REPDEL_IGNORE_ERRORS
Ignora qualquer erro gerado ao entrar em contato com a origem para instruí-la a remover essa NC de sua lista de servidores para os quais ele replica.
DS_REPDEL_INTERSITE_MESSAGING
Significa que a réplica é baseada em email em vez de sincronizada usando o RPC do serviço de diretório nativo.
DS_REPDEL_LOCAL_ONLY
Não entra em contato com a origem para informá-la para remover essa NC de sua lista de servidores para os 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 somente para NCs somente leitura sem origem.
DS_REPDEL_REF_OK
Permite a exclusão de uma réplica somente leitura, mesmo se ela originar outras réplicas somente leitura.
DS_REPDEL_WRITEABLE
Significa que a réplica excluída pode ser gravada.
Valor de retorno
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.
Observações
Nota
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 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