Função DsDeregisterDnsHostRecordsA (dsgetdc.h)
A função DsDeregisterDnsHostRecords exclui entradas DNS, exceto para registros do tipo A registrados por um controlador de domínio. Somente um administrador, operador de conta ou operador de servidor pode chamar essa função.
Sintaxe
DSGETDCAPI DWORD DsDeregisterDnsHostRecordsA(
[in, optional] LPSTR ServerName,
[in, optional] LPSTR DnsDomainName,
[in, optional] GUID *DomainGuid,
[in, optional] GUID *DsaGuid,
[in] LPSTR DnsHostName
);
Parâmetros
[in, optional] ServerName
A cadeia de caracteres terminada em nulo que especifica o nome do controlador de domínio remoto. Pode ser definido como NULL se o aplicativo de chamada estiver em execução no controlador de domínio que está sendo atualizado.
[in, optional] DnsDomainName
A cadeia de caracteres terminada em nulo que especifica o nome de domínio DNS do domínio ocupado pelo controlador de domínio. É desnecessário que esse seja um domínio hospedado por esse controlador de domínio. Se NULL, o DnsHostName com o rótulo mais à esquerda removido será especificado.
[in, optional] DomainGuid
Ponteiro para o GUID de Domínio do domínio. Se NULL, os nomes específicos do GUID não serão removidos.
[in, optional] DsaGuid
Ponteiro para o GUID do objeto NTDS-DSA a ser excluído. Se NULL, os nomes específicos do NTDS-DSA não serão removidos.
[in] DnsHostName
Ponteiro para a cadeia de caracteres terminada em nulo que especifica o nome do host DNS do controlador de domínio cujos registros DNS estão sendo excluídos.
Retornar valor
Essa função retorna DWORD DSGETDCAPI.
Comentários
Essa função desregistre somente registros SRV e CNAME. Deixa os registros tipo A intactos. Exclusão de registros específicos do site, por exemplo, _ldap. Tcp.<SiteName>._sites.dc._msdcs.<DnsDomainName>, é tentada para cada site (<SiteName> neste exemplo) na empresa do controlador de domínio no qual a função é executada. Portanto, essa chamada de função pode criar uma execução demorada e pode gerar tráfego de rede significativo para empresas com muitos sites.
Observação
O cabeçalho dsgetdc.h define DsDeregisterDnsHostRecords 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 | dsgetdc.h |
Biblioteca | Netapi32.lib |
DLL | Netapi32.dll |