Функция DnsReplaceRecordSetA (windns.h)

Статья
11/20/2024

Тип функции DnsReplaceRecordSet заменяет существующий набор записей ресурсов (RR). Как и многие функции DNS, тип функции DnsReplaceRecordSet реализуется в нескольких формах для упрощения разной кодировки символов, которая обозначается суффиксом. В зависимости от используемой кодировки символов используйте одну из следующих функций:

DnsReplaceRecordSetA (_A для кодирования ANSI)

DnsReplaceRecordSetW (_W для кодировки Юникода)

DnsReplaceRecordSetUTF8 (_UTF8 для кодировки UTF 8)

Учитывайте отсутствие подчеркивания между именем типа функции и его суффиксом. Если тип функции 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.

Возвращаемое значение

Возвращает подтверждение успешности после успешного завершения. В противном случае возвращает соответствующий код ошибки, зависящий от DNS, как определено в Winerror.h.

Замечания

Заметка

Заголовок windns.h определяет DnsReplaceRecordSet как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	windns.h
библиотеки	Dnsapi.lib
DLL	Dnsapi.dll

См. также

DNS_RECORD

DnsModifyRecordsInSet

Поделиться через