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

Статья
03/13/2024

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

DnsWriteQuestionToBuffer_W (_W для кодировки Юникода)
DnsWriteQuestionToBuffer_UTF8 (_UTF8 для кодировки UTF-8)

Если тип функции DnsWriteQuestionToBuffer используется без его суффикса (_W или _UTF8), возникнет ошибка компилятора.

Синтаксис

BOOL DnsWriteQuestionToBuffer_UTF8(
  [in, out] PDNS_MESSAGE_BUFFER pDnsBuffer,
  [in, out] PDWORD              pdwBufferSize,
  [in]      PCSTR               pszName,
  [in]      WORD                wType,
  [in]      WORD                Xid,
  [in]      BOOL                fRecursionDesired
);

Параметры

[in, out] pDnsBuffer

Указатель на структуру DNS_MESSAGE_BUFFER , содержащую сообщение запроса DNS, хранящееся в буфере.

[in, out] pdwBufferSize

Размер (в байтах) буфера, выделенного для хранения pDnsBuffer. Если размер буфера недостаточен для хранения сообщения, возвращается значение FALSE , а pdwBufferSize содержит минимальный необходимый размер буфера.

[in] pszName

Указатель на строку, представляющую имя владельца запрашиваемого набора записей.

[in] wType

Значение типа , представляющее тип записи DNS RR. wType определяет формат Данных. Например, если значение wType равно DNS_TYPE_A, тип данных DataDNS_A_DATA.

[in] Xid

Значение типа , указывающее уникальный идентификатор запроса DNS.

[in] fRecursionDesired

Значение ТИПА BOOL, указывающее, должен ли dns-сервер dns-имен использовать рекурсивный запрос имени. Задайте значение TRUE , чтобы запросить запрос рекурсивного имени, и FALSE для запроса запроса на итеративное имя.

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

Возвращает значение TRUE при успешном выполнении, в противном случае — ЗНАЧЕНИЕ FALSE.

BOOL
WINAPI
DnsWriteQuestionToBuffer_UTF8(
    __inout     PDNS_MESSAGE_BUFFER pDnsBuffer,
    __inout     PDWORD              pdwBufferSize,
    __in        PCSTR               pszName,
    __in        WORD                wType,
    __in        WORD                Xid,
    __in        BOOL                fRecursionDesired
    );

Требования

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

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

DNS_MESSAGE_BUFFER

DNS_RECORD

DnsQuery

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