共用方式為

DnsModifyRecordsInSet_A函式 （windns.h）

  • 發行項

DnsModifyRecordsInSet 函式會新增、修改或移除先前已向 DNS 伺服器註冊的資源記錄 （RR） 集合。

和許多 DNS 函式一樣，DnsModifyRecordsInSet 函式類型會以多個形式實作，以促進不同的字元編碼。 根據所涉及的字元編碼方式，使用下列其中一個函式：

  • DnsModifyRecordsInSet_A （ANSI 編碼_A）
  • DnsModifyRecordsInSet_W （Unicode 編碼的_W）
  • DnsModifyRecordsInSet_UTF8 （UTF 8 編碼的_UTF8）

語法

DNS_STATUS DnsModifyRecordsInSet_A(
  [in, optional]      PDNS_RECORD pAddRecords,
  [in, optional]      PDNS_RECORD pDeleteRecords,
  [in]                DWORD       Options,
  [in, optional]      HANDLE      hCredentials,
  [in, out, optional] PVOID       pExtraList,
  [in, out, optional] PVOID       pReserved
);

參數

[in, optional] pAddRecords

包含要加入至 RR 集合之 R 之 DNS_RECORD 結構的指標。

[in, optional] pDeleteRecords

DNS_RECORD 結構的指標，其中包含要從 RR 集合中刪除的 RR。

[in] Options

值，包含 DNS 更新選項的點陣圖。 選項可以合併，而且所有選項都會覆寫 DNS_UPDATE_SECURITY_USE_DEFAULT。

[in, optional] hCredentials

特定帳戶之認證的句柄。 需要安全動態更新時使用。 這個參數是選擇性的。

[in, out, optional] pExtraList

此參數保留供日後使用，且必須設定為 NULL。

[in, out, optional] pReserved

此參數保留供日後使用，且必須設定為 NULL。

傳回值

在成功完成時傳回成功確認。 否則，它會傳回 Winerror.h 中所定義的適當 DNS 特定錯誤碼。

言論

DnsModifyRecordsInSet 函式類型會在下列步驟中執行。

  1. 刪除 pDeleteRecords 中指定的記錄。 如果 pDeleteRecords 是空的，或不包含存在於目前集合中的記錄，DnsModifyRecordsInSet 函式會移至下一個步驟。
  2. 會新增 pAddRecords 中指定的記錄。 如果 pAddRecords 是空的，則作業會完成而不新增任何記錄。
若要新增新記錄，請在 pDeleteRecords中提供任何記錄，並提供要加入 pAddRecords中的記錄。 若要修改記錄，請指定在 pDeleteRecords 中修改的記錄，然後將該記錄的修改版本放在 pAddRecords。 若要刪除記錄，請只指定要刪除的記錄。 您可以在單一呼叫中新增或刪除多個記錄，DnsModifyRecordsInSet;不過，每個 DNS_RECORD 中 pName 成員的值必須相同，否則呼叫將會失敗。 如果 pAddRecords 中指定的記錄已經存在，則不會發生任何變更。

如果未指定任何伺服器清單，則會查詢預設名稱伺服器。

要求

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

另請參閱

DNS_RECORD

DnsQuery

DnsReplaceRecordSet