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

Статья
01/16/2025

Функция 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, которые нужно удалить из набора 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.

Замечания

Тип функции DnsModifyRecordsInSet выполняется в следующих шагах.

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

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

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

Требования

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

См. также

DNS_RECORD

DnsQuery

DnsReplaceRecordSet

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