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

Статья
11/08/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 определяет формат данных. Например, если значение wTypeDNS_TYPE_A, тип данных DataDNS_A_DATA.

[in] Xid

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

[in] fRecursionDesired

BoOL, указывающий, должен ли рекурсивный запрос имени использоваться DNS-сервером имен. Задайте значение TRUE для запроса запроса рекурсивного имени FALSE для запроса итеративного запроса имени.

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

Возвращает TRUE при успешном выполнении, в противном случае FALSE.

Замечания

Следующее объявление для DnsWriteQuestionToBuffer_UTF8 можно найти в Windns.h.

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

См. также

DNS_MESSAGE_BUFFER

DNS_RECORD

DnsQuery

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