共用方式為

DnsModifyRecordsInSet_A函式 (windns.h)

  • 發行項

DnsModifyRecordsInSet 函式會新增、修改或移除資源記錄 (RR) 集，這些集合可能先前已向 DNS 伺服器註冊。

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

  • anSI 編碼DnsModifyRecordsInSet_A (_A)
  • DnsModifyRecordsInSet_W (_W Unicode 編碼)
  • UTF 8 編碼DnsModifyRecordsInSet_UTF8 (_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 集合之 RU 之DNS_RECORD 結構的指標。

[in, optional] pDeleteRecords

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

[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 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 windns.h
程式庫 Dnsapi.lib
Dll Dnsapi.dll

另請參閱

DNS_RECORD

DnsQuery

DnsReplaceRecordSet