DnsReplaceRecordSetA 関数 (windns.h)
DnsReplaceRecordSet 関数の種類は、既存のリソース レコード (RR) セットを置き換えます。 多くの DNS 関数と同様に、 DnsReplaceRecordSet 関数の種類は、サフィックスで示される異なる文字エンコードを容易にするために、複数の形式で実装されます。 関連する文字エンコードに基づいて、次のいずれかの関数を使用します。
DnsReplaceRecordSetA (ANSI エンコードの_A)
DnsReplaceRecordSetW (Unicode エンコードの_W)
DnsReplaceRecordSetUTF8 (UTF 8 エンコードの_UTF8)
関数の型名とそのサフィックスの間にアンダースコアがないことに注意してください。 DnsReplaceRecordSet 関数の型がサフィックス (A、W、または UTF8) なしで呼び出されると、コンパイラ エラーが発生します。
構文
DNS_STATUS DnsReplaceRecordSetA(
[in] PDNS_RECORD pReplaceSet,
[in] DWORD Options,
[in, optional] HANDLE hContext,
[in, out, optional] PVOID pExtraInfo,
[in, out, optional] PVOID pReserved
);
パラメーター
[in] pReplaceSet
既存の セットを置 き換える RR セットを含むDNS_RECORD構造体へのポインター。 指定された RR セットは 、pNewSet の内容に置き換えられます。 RR セットを削除するには、 pNewSet でセットを指定しますが、 RDATA を NULL に設定します。
[in] Options
DNS 更新オプションのビットマップを含む 値。 オプションを組み合わせて、すべてのオプション がDNS_UPDATE_SECURITY_USE_DEFAULTをオーバーライドできます。
[in, optional] hContext
特定のアカウントの資格情報のハンドル。 セキュリティで保護された動的更新が必要な場合に使用されます。 このパラメーターは省略可能です。
[in, out, optional] pExtraInfo
このパラメーターは将来使用するために予約されており、 NULL に設定する必要があります。
[in, out, optional] pReserved
このパラメーターは将来使用するために予約されており、 NULL に設定する必要があります。
戻り値
正常に完了すると、成功の確認が返されます。 それ以外の場合は、Winerror.h で定義されている適切な DNS 固有のエラー コードを返します。
注釈
注意
windns.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして DnsReplaceRecordSet を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | windns.h |
| Library | Dnsapi.lib |
| [DLL] | Dnsapi.dll |