RxSetDomainForMailslotBroadcast-Funktion (mrx.h)

Artikel
10/13/2023

RxSetDomainForMailslotBroadcast wird von einem Netzwerk-Mini-Redirector-Treiber aufgerufen, um die domäne festzulegen, die für Mailslot-Übertragungen verwendet wird, wenn mailslots vom Treiber unterstützt werden.

Syntax

NTSTATUS RxSetDomainForMailslotBroadcast(
  [in] IN PUNICODE_STRING DomainName
);

Parameter

[in] DomainName

Ein Zeiger auf einen Puffer, der eine Unicode-Zeichenfolge mit Null-Beendigung enthält, die die Domäne benennt, die für Mailslots verwendet werden soll.

Rückgabewert

RxSetDomainForMailslotBroadcast gibt STATUS_SUCCESS bei Erfolg oder einen der folgenden Fehlerwerte bei Fehler zurück:

Rückgabecode	Beschreibung
STATUS_INSUFFICIENT_RESOURCES	Es gab nicht genügend Ressourcen, um diese Routine abzuschließen. Fehler bei der Speicherzuordnungsanforderung für den nicht auslagerten Poolspeicher zum Speichern des Domänennamens.

Hinweise

Ein Netzwerkminiumleitungsor registriert sich bei RDBSS, wenn der Treiber vom Kernel geladen wird, und hebt die Registrierung bei RDBSS auf, wenn der Treiber entladen wird. Dieser Registrierungsprozess ist ein bidirektionales Handschütteln, bei dem der Netzwerk-Mini-Redirector RDBSS informiert, dass er geladen wurde, indem er RxRegisterMinirdr aufruft, die aus RDBSS exportierte Registrierungsroutine. RDBSS schließt den Registrierungs- und Initialisierungsprozess ab, indem MrxStart aufgerufen wird, eine der Rückrufroutinen, die vom Netzwerkmini-Redirector exportiert und als Teil der Verteilungstabelle an RxRegisterMinirdr übergeben werden.

Einer der Parameter, die an die RxRegisterMinirdr-Routine übergeben werden, gibt an, ob der Netzwerk-Mini-Redirector mailslots unterstützt. Ein Netzwerkminiumleitungsor ruft normalerweise RxSetDomainForMailslotBroadcast aus der MrxStart-Routine oder im Rahmen einer externen Anforderung auf, den Treiber zu starten, der von einer Dateisystemsteuerung (FSCTRL) oder einer I/O-Steuerungsanforderung (IOCTL) aus einer Anwendung oder einem Dienst im Benutzermodus initiiert wird.