Функция DnsReplaceRecordSetA (windns.h)
Тип функции 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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | windns.h |
Библиотека | Dnsapi.lib |
DLL | Dnsapi.dll |