Função DsDeregisterDnsHostRecordsW (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 DsDeregisterDnsHostRecordsW(
  [in, optional] LPWSTR ServerName,
  [in, optional] LPWSTR DnsDomainName,
  [in, optional] GUID   *DomainGuid,
  [in, optional] GUID   *DsaGuid,
  [in]           LPWSTR 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.

Requisitos

Consulte também

DsGetDcSiteCoverage

DsGetSiteName