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 更新オプションのビットマップを含む値。 オプションを組み合わせることができ、すべてのオプションが 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 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | windns.h |
| ライブラリ | Dnsapi.lib |
| DLL | Dnsapi.dll |