Função DsDeregisterDnsHostRecordsA (dsgetdc.h)

Artigo
11/20/2024

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, NTDS-DSA nomes específicos 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.

Valor de retorno

Essa função retorna DWORD DSGETDCAPI.

Observações

Essa função desregista somente registros SRV e CNAME. Deixa os registros do 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 um tráfego de rede significativo para empresas com muitos sites.

Nota

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 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	dsgetdc.h
biblioteca	Netapi32.lib
de DLL	Netapi32.dll

Consulte também

DsGetDcSiteCoverage

DsGetSiteName

Compartilhar via