Funzione DsDeregisterDnsHostRecordsA (dsgetdc.h)

Articolo
08/23/2023

La funzione DsDeregisterDnsHostRecords elimina le voci DNS, ad eccezione del tipo A record registrati da un controller di dominio. Solo un amministratore, un operatore account o un operatore server possono chiamare questa funzione.

Sintassi

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

Parametri

[in, optional] ServerName

Stringa con terminazione null che specifica il nome del controller di dominio remoto. Può essere impostato su NULL se l'applicazione chiamante è in esecuzione nel controller di dominio da aggiornare.

[in, optional] DnsDomainName

Stringa con terminazione null che specifica il nome di dominio DNS del dominio occupato dal controller di dominio. Non è necessario che questo sia un dominio ospitato da questo controller di dominio. Se NULL, viene specificato dnsHostName con l'etichetta più a sinistra rimossa.

[in, optional] DomainGuid

Puntatore al GUID di dominio del dominio. Se NULL, i nomi specifici del GUID non vengono rimossi.

[in, optional] DsaGuid

Puntatore al GUID dell'oggetto NTDS-DSA da eliminare. Se NULL, i nomi specifici ntDS-DSA non vengono rimossi.

[in] DnsHostName

Puntatore alla stringa con terminazione null che specifica il nome host DNS del controller di dominio i cui record DNS vengono eliminati.

Valore restituito

Questa funzione restituisce DSGETDCAPI DWORD.

Commenti

Questa funzione deregisters solo record SRV e CNAME. Lascia intatti i record A. Eliminazione di record specifici del sito, ad esempio _ldap. Tcp.<SiteName>._sites.dc._msdcs.<DnsDomainName viene tentato per ogni sito (<SiteName>> in questo esempio) nell'organizzazione del controller di dominio in cui viene eseguita la funzione. Pertanto, questa chiamata di funzione potrebbe creare un'esecuzione che richiede tempo e può generare un traffico di rete significativo per le aziende con molti siti.

Nota

L'intestazione dsgetdc.h definisce DsDeregisterDnsHostRecords come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	dsgetdc.h
Libreria	Netapi32.lib
DLL	Netapi32.dll

Vedi anche

DsGetDcSiteCoverage

DsGetSiteName

Condividi tramite