Fungsi DsDeregisterDnsHostRecordsA (dsgetdc.h)

Artikel
03/05/2024

Fungsi DsDeregisterDnsHostRecords menghapus entri DNS, kecuali untuk catatan tipe A yang didaftarkan oleh pengendali domain. Hanya administrator, operator akun, atau operator server yang dapat memanggil fungsi ini.

Sintaks

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

Parameter

[in, optional] ServerName

String yang dihentikan null yang menentukan nama pengendali domain jarak jauh. Dapat diatur ke NULL jika aplikasi panggilan berjalan pada pengendali domain yang sedang diperbarui.

[in, optional] DnsDomainName

String null-terminated yang menentukan nama domain DNS domain yang ditempati oleh pengendali domain. Ini tidak perlu untuk menjadi domain yang dihosting oleh pengendali domain ini. Jika NULL, DnsHostName dengan label paling kiri yang dihapus ditentukan.

[in, optional] DomainGuid

Arahkan ke GUID Domain domain. Jika NULL, nama spesifik GUID tidak dihapus.

[in, optional] DsaGuid

Arahkan ke GUID objek NTDS-DSA yang akan dihapus. Jika NULL, nama spesifik NTDS-DSA tidak dihapus.

[in] DnsHostName

Penunjuk ke string yang dihentikan null yang menentukan nama host DNS pengontrol domain yang catatan DNS-nya sedang dihapus.

Mengembalikan nilai

Fungsi ini mengembalikan DSGETDCAPI DWORD.

Keterangan

Fungsi ini hanya membatalkan pendaftaran data SRV dan CNAME. Ini membuat catatan tipe A utuh. Penghapusan rekaman khusus situs, misalnya, _ldap. Tcp.<SiteName>._sites.dc._msdcs.<DnsDomainName>, dicoba untuk setiap situs (<SiteName> dalam contoh ini) di perusahaan pengendali domain tempat fungsi dijalankan. Oleh karena itu, panggilan fungsi ini dapat membuat eksekusi yang memakan waktu dan dapat menghasilkan lalu lintas jaringan yang signifikan untuk perusahaan dengan banyak situs.

Catatan

Header dsgetdc.h mendefinisikan DsDeregisterDnsHostRecords sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	dsgetdc.h
Pustaka	Netapi32.lib
DLL	Netapi32.dll

Lihat juga

DsGetDcSiteCoverage

DsGetSiteName

Bagikan melalui