RxSetDomainForMailslotBroadcast, fonction (mrx.h)

Article
02/26/2024

RxSetDomainForMailslotBroadcast est appelé par un pilote de mini-redirecteur réseau pour définir le domaine utilisé pour les diffusions maillot si les mailslots sont pris en charge par le pilote.

Syntaxe

NTSTATUS RxSetDomainForMailslotBroadcast(
  [in] IN PUNICODE_STRING DomainName
);

Paramètres

[in] DomainName

Pointeur vers une mémoire tampon qui contient une chaîne Unicode sans fin qui nomme le domaine à utiliser pour les mailslots.

Valeur retournée

RxSetDomainForMailslotBroadcast retourne STATUS_SUCCESS en cas de réussite ou l’une des valeurs d’erreur suivantes en cas d’échec :

Code de retour	Description
STATUS_INSUFFICIENT_RESOURCES	Les ressources étaient insuffisantes pour effectuer cette routine. La demande d’allocation de mémoire a échoué pour que la mémoire du pool non paginé stocke le nom de domaine.

Remarques

Un mini-redirecteur réseau s’inscrit auprès de RDBSS chaque fois que le pilote est chargé par le noyau et se désinscrit auprès de RDBSS lorsque le pilote est déchargé. Ce processus d’inscription est une poignée de main bidirectionnel dans laquelle le mini-redirecteur réseau informe RDBSS qu’il a été chargé en appelant RxRegisterMinirdr, la routine d’inscription exportée à partir de RDBSS. RDBSS termine le processus d’inscription et d’initialisation en appelant MrxStart, l’une des routines de rappel exportées par le mini-redirecteur réseau et transmises dans le cadre de la table dispatch à RxRegisterMinirdr.

L’un des paramètres passés à la routine RxRegisterMinirdr indique si le mini-redirecteur réseau prend en charge les mailslots. Un mini-redirecteur réseau appelle normalement RxSetDomainForMailslotBroadcast à partir de la routine MrxStart ou dans le cadre d’une demande externe pour démarrer le pilote lancé par un contrôle de système de fichiers (FSCTRL) ou une demande de contrôle d’E/S (IOCTL) à partir d’une application ou d’un service en mode utilisateur.