Funzione RxSetDomainForMailslotBroadcast (mrx.h)

Articolo
02/26/2024

RxSetDomainForMailslotBroadcast viene chiamato da un driver mini-redirector di rete per impostare il dominio utilizzato per le trasmissioni mailslot se i messaggi di posta sono supportati dal driver.

Sintassi

NTSTATUS RxSetDomainForMailslotBroadcast(
  [in] IN PUNICODE_STRING DomainName
);

Parametri

[in] DomainName

Puntatore a un buffer che contiene una stringa Unicode con terminazione zero che assegna un nome al dominio da usare per i mailslot.

Valore restituito

RxSetDomainForMailslotBroadcast restituisce STATUS_SUCCESS in caso di esito positivo o uno dei valori di errore seguenti in caso di errore:

Codice restituito	Descrizione
STATUS_INSUFFICIENT_RESOURCES	Non sono state eseguite risorse sufficienti per completare questa routine. La richiesta di allocazione della memoria non è riuscita per la memoria del pool non di paging per archiviare il nome di dominio.

Commenti

Un mini-redirector di rete viene registrato con RDBSS ogni volta che il driver viene caricato dal kernel e annulla la registrazione con RDBSS quando il driver viene scaricato. Questo processo di registrazione è una scossa a due vie in cui il mini-redirector di rete informa RDBSS che è stato caricato chiamando RxRegisterMinirdr, la routine di registrazione esportata da RDBSS. RDBSS completa il processo di registrazione e inizializzazione chiamando MrxStart, una delle routine di callback esportate dal mini-redirector di rete e passate come parte della tabella dispatch a RxRegisterMinirdr.

Uno dei parametri passati alla routine RxRegisterMinirdr indica se il mini-redirector di rete supporta mailslot. Un mini-redirector di rete chiamerebbe in genere RxSetDomainForMailslotBroadcast dalla routine MrxStart o come parte di una richiesta esterna per avviare il driver avviato da un controllo DEL FILE SYSTEM (MDFTRL) o da una richiesta di controllo I/O (IOCTL) da un'applicazione o un servizio in modalità utente.