DsDeregisterDnsHostRecordsA 関数 (dsgetdc.h)

  • [アーティクル]

DsDeregisterDnsHostRecords 関数は、ドメイン コントローラーによって登録された A 型のレコードを除き、DNS エントリを削除します。 この関数を呼び出できるのは、管理者、アカウントオペレーター、またはサーバーオペレーターだけです。

構文

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

パラメーター

[in, optional] ServerName

リモート ドメイン コントローラーの名前を指定する null で終わる文字列。 呼び出し元のアプリケーションが更新されるドメイン コントローラーで実行されている場合は 、NULL に設定できます。

[in, optional] DnsDomainName

ドメイン コントローラーによって占有されるドメインの DNS ドメイン名を指定する null で終わる文字列。 これは、このドメイン コントローラーによってホストされるドメインである必要があります。 NULL の場合、左端のラベルが削除された DnsHostName が指定されます。

[in, optional] DomainGuid

ドメインのドメイン GUID へのポインター。 NULL の場合、GUID 固有の名前は削除されません。

[in, optional] DsaGuid

削除する NTDS-DSA オブジェクトの GUID へのポインター。 NULL の場合、NTDS-DSA 固有の名前は削除されません。

[in] DnsHostName

DNS レコードが削除されるドメイン コントローラーの DNS ホスト名を指定する null で終わる文字列へのポインター。

戻り値

この関数は DSGETDCAPI DWORD を返します。

注釈

この関数は、SRV レコードと CNAME レコードのみを登録解除します。 A 型のレコードはそのまま残ります。 サイト固有のレコードの削除 (_ldapなど)。Tcp。<SiteName>._sites.dc._msdcs。<DnsDomainName> は、関数が実行されるドメイン コントローラーのエンタープライズ内のすべてのサイト (<この例では SiteName> ) に対して試行されます。 そのため、この関数呼び出しによって実行に時間がかかり、多くのサイトを持つ企業に対して大量のネットワーク トラフィックが生成される可能性があります。

注意

dsgetdc.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして DsDeregisterDnsHostRecords を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista
サポートされている最小のサーバー Windows Server 2008
対象プラットフォーム Windows
ヘッダー dsgetdc.h
Library Netapi32.lib
[DLL] Netapi32.dll

こちらもご覧ください

DsGetDcSiteCoverage

DsGetSiteName