次の方法で共有


DnsReplaceRecordSetUTF8 関数 (windns.h)

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

DnsReplaceRecordSetA (ANSI エンコードの_A)

DnsReplaceRecordSetW (Unicode エンコードの_W)

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

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

構文

DNS_STATUS DnsReplaceRecordSetUTF8(
  [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 でセットを指定しますが、 RDATANULL に設定します。

[in] Options

DNS Update Options のビットマップを含む値。 オプションは組み合わせることができ、すべてのオプション はDNS_UPDATE_SECURITY_USE_DEFAULTをオーバーライドできます。

[in, optional] hContext

特定のアカウントの資格情報へのハンドル。 セキュリティで保護された動的更新が必要な場合に使用されます。 このパラメーターは省略可能です。

[in, out, optional] pExtraInfo

このパラメーターは将来使用するために予約されており、 NULL に設定する必要があります。

[in, out, optional] pReserved

このパラメーターは将来使用するために予約されており、 NULL に設定する必要があります。

戻り値

正常に完了すると、成功の確認を返します。 それ以外の場合は、Winerror.h で定義されている適切な DNS 固有のエラー コードを返します。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー windns.h
Library Dnsapi.lib
[DLL] Dnsapi.dll

関連項目

DNS_RECORD

DnsModifyRecordsInSet