Condividi tramite

Funzione DsDeregisterDnsHostRecordsW (dsgetdc.h)

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 può chiamare questa funzione.

Sintassi

DSGETDCAPI DWORD DsDeregisterDnsHostRecordsW(
  [in, optional] LPWSTR ServerName,
  [in, optional] LPWSTR DnsDomainName,
  [in, optional] GUID   *DomainGuid,
  [in, optional] GUID   *DsaGuid,
  [in]           LPWSTR 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 il 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, NTDS-DSA nomi specifici 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.

Osservazioni

Questa funzione deregista solo record SRV e CNAME. Lascia intatti i record di tipo A. Eliminazione di record specifici del sito, ad esempio _ldap.tcp.<SiteName>._sites.dc._msdcs.<DnsDomainName>, viene eseguito un tentativo 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 dispendiosa in termini di tempo e può generare 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows Vista
server minimo supportato Windows Server 2008
piattaforma di destinazione Finestre
intestazione dsgetdc.h
libreria Netapi32.lib
dll Netapi32.dll

Vedere anche

DsGetDcSiteCoverage

DsGetSiteName

  • Last updated on