共用方式為

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

DNS_RECORD 結構的指標，其中包含取代現有集合的 RR 集合。 指定的 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 標頭會將 DnsReplaceRecordSet 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 windns.h
連結庫 Dnsapi.lib
DLL Dnsapi.dll

另請參閱

DNS_RECORD

DnsModifyRecordsInSet