функция DnsModifyRecordsInSet_A (windns.h)

Статья
03/13/2024

Функция DnsModifyRecordsInSet добавляет, изменяет или удаляет набор записей ресурсов (RR), который мог быть ранее зарегистрирован на DNS-серверах.

Как и многие функции DNS, тип функции DnsModifyRecordsInSet реализуется в нескольких формах для упрощения разной кодировки символов. В зависимости от используемой кодировки символов используйте одну из следующих функций:

DnsModifyRecordsInSet_A (_A для кодировки ANSI)
DnsModifyRecordsInSet_W (_W для кодировки Юникода)
DnsModifyRecordsInSet_UTF8 (_UTF8 для кодировки UTF 8)

Синтаксис

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

Указатель на структуру DNS_RECORD , содержащую RR, добавляемые в набор RR.

[in, optional] pDeleteRecords

Указатель на структуру DNS_RECORD , содержащую запросы на запросы, удаляемые из набора RR.

[in] Options

Значение типа , содержащее растровое изображение параметров обновления DNS. Параметры можно объединять, и все параметры переопределяются DNS_UPDATE_SECURITY_USE_DEFAULT.

[in, optional] hCredentials

Дескриптор учетных данных определенной учетной записи. Используется, когда требуется безопасное динамическое обновление. Этот параметр является необязательным.

[in, out, optional] pExtraList

Этот параметр зарезервирован для использования в будущем и должен иметь значение NULL.

[in, out, optional] pReserved

Этот параметр зарезервирован для использования в будущем и должен иметь значение NULL.

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

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

Записи, указанные в pDeleteRecords , удаляются. Если pDeleteRecords пуст или не содержит записей, существующих в текущем наборе, функция DnsModifyRecordsInSet переходит к следующему шагу.
Добавляются записи, указанные в pAddRecords . Если параметр pAddRecords пуст, операция завершается без добавления записей.

Чтобы добавить новую запись, не укажите записи в pDeleteRecords и укажите запись, добавляемую в pAddRecords. Чтобы изменить запись, укажите запись, изменяемую в pDeleteRecords, а затем добавьте измененную версию этой записи, поместив ее в pAddRecords. Чтобы удалить записи, укажите только записи, которые будут удалены. В одном вызове DnsModifyRecordsInSet можно добавить или удалить несколько записей; Однако значение элемента pName в каждой DNS_RECORD должно быть одинаковым, иначе вызов завершится ошибкой. Если запись, указанная в pAddRecords , уже присутствует, изменения не происходят.

Если список серверов не указан, запрашивается сервер имен по умолчанию.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	windns.h
Библиотека	Dnsapi.lib
DLL	Dnsapi.dll

См. также раздел

DNS_RECORD

DnsQuery

DnsReplaceRecordSet

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