Fonction DsDeregisterDnsHostRecordsW (dsgetdc.h)

  • Article

La fonction DsDeregisterDnsHostRecords supprime les entrées DNS, à l’exception des enregistrements de type A inscrits par un contrôleur de domaine. Seul un administrateur, un opérateur de compte ou un opérateur de serveur peut appeler cette fonction.

Syntaxe

DSGETDCAPI DWORD DsDeregisterDnsHostRecordsW(
  [in, optional] LPWSTR ServerName,
  [in, optional] LPWSTR DnsDomainName,
  [in, optional] GUID   *DomainGuid,
  [in, optional] GUID   *DsaGuid,
  [in]           LPWSTR DnsHostName
);

Paramètres

[in, optional] ServerName

Chaîne terminée par null qui spécifie le nom du contrôleur de domaine distant. Peut être défini sur NULL si l’application appelante s’exécute sur le contrôleur de domaine en cours de mise à jour.

[in, optional] DnsDomainName

Chaîne terminée par null qui spécifie le nom de domaine DNS du domaine occupé par le contrôleur de domaine. Il n’est pas nécessaire qu’il s’agit d’un domaine hébergé par ce contrôleur de domaine. Si la valeur est NULL, le DnsHostName avec l’étiquette la plus à gauche supprimée est spécifié.

[in, optional] DomainGuid

Pointeur vers le GUID de domaine du domaine. Si la valeur est NULL, les noms spécifiques au GUID ne sont pas supprimés.

[in, optional] DsaGuid

Pointeur vers le GUID de l’objet NTDS-DSA à supprimer. Si la valeur est NULL, les noms spécifiques à NTDS-DSA ne sont pas supprimés.

[in] DnsHostName

Pointeur vers la chaîne null qui spécifie le nom d’hôte DNS du contrôleur de domaine dont les enregistrements DNS sont supprimés.

Valeur retournée

Cette fonction retourne DSGETDCAPI DWORD.

Notes

Cette fonction annule l’inscription des enregistrements SRV et CNAME uniquement. Il laisse les enregistrements de type A intacts. Suppression d’enregistrements spécifiques au site, par exemple, _ldap. Tcp.<SiteName>._sites.dc._msdcs.<DnsDomainName> est tenté pour chaque site (<SiteName> dans cet exemple) dans l’entreprise du contrôleur de domaine sur lequel la fonction est exécutée. Par conséquent, cet appel de fonction peut créer une exécution chronophage et peut générer un trafic réseau important pour les entreprises disposant de nombreux sites.

Notes

L’en-tête dsgetdc.h définit DsDeregisterDnsHostRecords comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Spécifications

   
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête dsgetdc.h
Bibliothèque Netapi32.lib
DLL Netapi32.dll

Voir aussi

DsGetDcSiteCoverage

DsGetSiteName