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