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 固有のエラー コードを返します。

注釈

要件

こちらもご覧ください

DNS_RECORD

DnsModifyRecordsInSet