Función DsDeregisterDnsHostRecordsA (dsgetdc.h)

La función DsDeregisterDnsHostRecords elimina entradas DNS, excepto los registros A registrados por un controlador de dominio. Solo un administrador, un operador de cuenta o un operador de servidor pueden llamar a esta función.

Sintaxis

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

Cadena terminada en null que especifica el nombre del controlador de dominio remoto. Se puede establecer en NULL si la aplicación que realiza la llamada se ejecuta en el controlador de dominio que se está actualizando.

[in, optional] DnsDomainName

Cadena terminada en null que especifica el nombre de dominio DNS del dominio ocupado por el controlador de dominio. No es necesario que sea un dominio hospedado por este controlador de dominio. Si es NULL, se especifica DnsHostName con la etiqueta situada más a la izquierda.

[in, optional] DomainGuid

Puntero al GUID de dominio del dominio. Si es NULL, no se quitan los nombres específicos del GUID.

[in, optional] DsaGuid

Puntero al GUID del objeto NTDS-DSA que se va a eliminar. Si es NULL, no se quitan los nombres específicos de NTDS-DSA .

[in] DnsHostName

Puntero a la cadena terminada en null que especifica el nombre de host DNS del controlador de dominio cuyos registros DNS se eliminan.

Valor devuelto

Esta función devuelve DWORD DWORD de DSGETDCDCAPI.

Comentarios

Esta función solo registra los registros SRV y CNAME. Deja intactos los registros A. Eliminación de registros específicos del sitio, por ejemplo, _ldap. Tcp.<SiteName>._sites.dc._msdcs.<DnsDomainName>, se intenta para cada sitio (<SiteName> en este ejemplo) en la empresa del controlador de dominio en el que se ejecuta la función. Por lo tanto, esta llamada de función podría crear una ejecución que consume mucho tiempo y puede generar tráfico de red significativo para empresas con muchos sitios.

Nota

El encabezado dsgetdc.h define DsDeregisterDnsHostRecords como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	dsgetdc.h
Library	Netapi32.lib
Archivo DLL	Netapi32.dll

Consulte también

DsGetDcSiteCoverage

DsGetSiteName