Share via

Função DsDeregisterDnsHostRecordsA (dsgetdc.h)

  • Artigo

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

Confira também

DsGetDcSiteCoverage

DsGetSiteName