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 |