Функция RxSetDomainForMailslotBroadcast (mrx.h)

Статья
10/11/2023

RxSetDomainForMailslotBroadcast вызывается драйвером сетевого мини-перенаправления, чтобы задать домен, используемый для широковещательных трансляций mailslots, если почтовые площадки поддерживаются драйвером.

Синтаксис

NTSTATUS RxSetDomainForMailslotBroadcast(
  [in] IN PUNICODE_STRING DomainName
);

Параметры

[in] DomainName

Указатель на буфер, содержащий строку Юникода с нулем, которая называет домен, используемый для почтовых слочков.

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

RxSetDomainForMailslotBroadcast возвращает STATUS_SUCCESS при успешном выполнении или одно из следующих значений ошибки при сбое:

Код возврата	Описание
STATUS_INSUFFICIENT_RESOURCES	Недостаточно ресурсов для выполнения этой процедуры. Сбой запроса на выделение памяти для нескладной памяти пула для хранения доменного имени.

Сетевой мини-перенаправитель регистрируется в RDBSS всякий раз, когда драйвер загружается ядром, и отменяет регистрацию в RDBSS при выгрузке драйвера. Этот процесс регистрации представляет собой двустороннее рукопожатие, при котором мини-перенаправитель сети сообщает RDBSS о том, что он был загружен путем вызова RxRegisterMinirdr, процедуры регистрации, экспортированной из RDBSS. RDBSS завершает процесс регистрации и инициализации, вызывая MrxStart, одну из подпрограмм обратного вызова, экспортированную мини-перенаправителем сети и передаваемую как часть таблицы диспетчеризации в RxRegisterMinirdr.

Один из параметров, передаваемых в подпрограмму RxRegisterMinirdr , указывает, поддерживает ли мини-перенаправление сети почтовые слои. Сетевой мини-перенаправитель обычно вызывает RxSetDomainForMailslotBroadcast из подпрограммы MrxStart или как часть внешнего запроса на запуск драйвера, инициированного элементом управления файловой системы (FSCTRL) или запросом управления вводом-выводом (IOCTL) из приложения или службы пользовательского режима.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	mrx.h (включая Mrx.h)
IRQL	<= APC_LEVEL