DnsModifyRecordsInSet_A関数 (windns.h)
DnsModifyRecordsInSet 関数は、以前に DNS サーバーに登録されている可能性があるリソース レコード (RR) セットを追加、変更、または削除します。
多くの DNS 関数と同様に、 DnsModifyRecordsInSet 関数の種類は、異なる文字エンコードを容易にするために複数の形式で実装されています。 関連する文字エンコードに基づいて、次のいずれかの関数を使用します。
- DnsModifyRecordsInSet_A (ANSI エンコードの_A)
- DnsModifyRecordsInSet_W (Unicode エンコードの_W)
- DnsModifyRecordsInSet_UTF8 (UTF 8 エンコードの_UTF8)
構文
DNS_STATUS DnsModifyRecordsInSet_A(
[in, optional] PDNS_RECORD pAddRecords,
[in, optional] PDNS_RECORD pDeleteRecords,
[in] DWORD Options,
[in, optional] HANDLE hCredentials,
[in, out, optional] PVOID pExtraList,
[in, out, optional] PVOID pReserved
);
パラメーター
[in, optional] pAddRecords
RR セットに追加する RR を含む DNS_RECORD 構造体へのポインター。
[in, optional] pDeleteRecords
RR セットから削除する RR を含む DNS_RECORD 構造体へのポインター。
[in] Options
DNS Update Options のビットマップを含む値。 オプションは組み合わせることができ、すべてのオプション はDNS_UPDATE_SECURITY_USE_DEFAULTをオーバーライドできます。
[in, optional] hCredentials
特定のアカウントの資格情報へのハンドル。 セキュリティで保護された動的更新が必要な場合に使用されます。 このパラメーターは省略可能です。
[in, out, optional] pExtraList
このパラメーターは将来使用するために予約されており、 NULL に設定する必要があります。
[in, out, optional] pReserved
このパラメーターは将来使用するために予約されており、 NULL に設定する必要があります。
戻り値
正常に完了すると、成功の確認を返します。 それ以外の場合は、Winerror.h で定義されている適切な DNS 固有のエラー コードが返されます。
注釈
DnsModifyRecordsInSet 関数の種類は、次の手順で実行されます。
- pDeleteRecords で指定されたレコードは削除されます。 pDeleteRecords が空の場合、または現在のセットに存在するレコードが含まれていない場合、DnsModifyRecordsInSet 関数は次の手順に進みます。
- pAddRecords で指定されたレコードが追加されます。 pAddRecords が空の場合、レコードを追加せずに操作が完了します。
サーバー リストが指定されていない場合は、既定のネーム サーバーに対してクエリが実行されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | windns.h |
| Library | Dnsapi.lib |
| [DLL] | Dnsapi.dll |