Функция RxSetDomainForMailslotBroadcast (mrx.h)
RxSetDomainForMailslotBroadcast вызывается драйвером мини-перенаправления сети, чтобы задать домен, используемый для трансляций mailslot, если почтовые ящики поддерживаются драйвером.
Синтаксис
NTSTATUS RxSetDomainForMailslotBroadcast(
[in] IN PUNICODE_STRING DomainName
);
Параметры
[in] DomainName
Указатель на буфер, содержащий строку Юникода, которая называет домен, используемый для почтовых объектов.
Возвращаемое значение
RxSetDomainForMailslotBroadcast возвращает STATUS_SUCCESS при успешном выполнении или одно из следующих значений ошибок при сбое:
Возвращаемый код | Описание |
---|---|
STATUS_INSUFFICIENT_RESOURCES | Для выполнения этой процедуры недостаточно ресурсов. Сбой запроса на выделение памяти для непагированного пула памяти для хранения доменного имени. |
Замечания
Сетевой мини-перенаправление регистрируется в RDBSSS всякий раз, когда драйвер загружается ядром и отменяет регистрацию с помощью RDBSS при выгрузке драйвера. Этот процесс регистрации является двусторонней рукой, в которой мини-перенаправление сети сообщает RDBSS, что он был загружен путем вызова RxRegisterMinirdr, подпрограммы регистрации, экспортированной из RDBSS. RDBSS завершает процесс регистрации и инициализации путем вызова MrxStart, одной из подпрограмм обратного вызова, экспортированных мини-перенаправлением сети и переданной в рамках таблицы отправки RxRegisterMinirdr.
Один из параметров, переданных в RxRegisterMinirdr подпрограммы, указывает, поддерживает ли мини-перенаправление сети почтовые слоты. Мини-перенаправление сети обычно вызывает RxSetDomainForMailslotBroad cast из процедуры MrxStart или как часть внешнего запроса, чтобы запустить драйвер, инициированный элементом управления файловой системой (FSCTRL) или запросом управления ввода-вывода (IOCTL) из приложения или службы в пользовательском режиме.
Требования
Требование | Ценность |
---|---|
целевая платформа | Настольный |
заголовка | mrx.h (include Mrx.h) |
IRQL | <= APC_LEVEL |