RxSetDomainForMailslotBroadcast 函式 (mrx.h)

發行項
02/26/2024

RxSetDomainForMailslotBroadcast 是由網路迷你重新導向器驅動程式呼叫，以在驅動程式支援 mailslot 廣播時設定用於 mailslot 廣播的網域。

語法

NTSTATUS RxSetDomainForMailslotBroadcast(
  [in] IN PUNICODE_STRING DomainName
);

參數

[in] DomainName

緩衝區的指標，其中包含以零結束的 Unicode 字串，將網域命名為用於mailslots。

傳回值

RxSetDomainForMailslotBroadcast 會在成功時傳回STATUS_SUCCESS，或在失敗時傳回下列其中一個錯誤值：

傳回碼	Description
STATUS_INSUFFICIENT_RESOURCES	資源不足，無法完成此例程。非分頁集區內存無法儲存功能變數名稱的記憶體配置要求。

備註

每當核心載入驅動程式時，網路迷你重新導向器會向 RDBSS 註冊，並在卸除驅動程式時向 RDBSS 取消註冊。此註冊程式是雙向的手勢，網路迷你重新導向器會通知 RDBSS 已透過呼叫 RxRegisterMinirdr 來載入，這是從 RDBSS 導出的註冊例程。 RDBSS 會藉由呼叫 MrxStart 來完成註冊和初始化程式，這是網路迷你重新導向器所導出的其中一個回呼例程，並作為分派數據表的一部分傳入 RxRegisterMinirdr。

傳遞至 RxRegisterMinirdr 例程的其中一個參數會指出網路迷你重新導向器是否支援 mailslot。網路迷你重新導向器通常會從 MrxStart 例程呼叫 RxSetDomainForMailslotBroadcast，或作為外部要求的一部分，以啟動由文件系統控件起始的驅動程式， (FSCTRL) 或 I/O 控件 (IOCTL) 來自使用者模式應用程式或服務的要求。