DnsReplaceRecordSetW 関数 (windns.h)

DnsReplaceRecordSet 関数型は、既存のリソース レコード (RR) セットを置き換えます。 多くの DNS 関数と同様に、DnsReplaceRecordSet 関数の種類は、サフィックスで示されるさまざまな文字エンコードを容易にするために複数の形式で実装されます。 関連する文字エンコードに基づいて、次のいずれかの関数を使用します。

DnsReplaceRecordSetA (ANSI エンコードの_A)

DnsReplaceRecordSetW (Unicode エンコードの_W)

DnsReplaceRecordSetUTF8 (UTF 8 エンコードの_UTF8)

関数型名とそのサフィックスの間にアンダースコアがないことに注意してください。 DnsReplaceRecordSet 関数型がサフィックス (A、W、または UTF8) なしで呼び出されると、コンパイラ エラーが発生します。

構文

DNS_STATUS DnsReplaceRecordSetW(
  [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 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	windns.h
ライブラリ	Dnsapi.lib
DLL	Dnsapi.dll

関連項目

DNS_RECORD

DnsModifyRecordsInSet