Função RxSetDomainForMailslotBroadcast (mrx.h)

Artigo
02/26/2024

RxSetDomainForMailslotBroadcast é chamado por um driver de minidiretório de rede para definir o domínio usado para transmissões de emaillot se os emailslots tiverem suporte do driver.

Sintaxe

NTSTATUS RxSetDomainForMailslotBroadcast(
  [in] IN PUNICODE_STRING DomainName
);

Parâmetros

[in] DomainName

Um ponteiro para um buffer que contém uma cadeia de caracteres Unicode terminada em zero que nomeia o domínio a ser usado para emailslots.

Retornar valor

RxSetDomainForMailslotBroadcast retorna STATUS_SUCCESS com êxito ou um dos seguintes valores de erro em caso de falha:

Código de retorno	Descrição
STATUS_INSUFFICIENT_RESOURCES	Não havia recursos suficientes para concluir essa rotina. Falha na solicitação de alocação de memória para memória de pool nãopagada para armazenar o nome de domínio.

Comentários

Um minidiretório de rede registra-se com RDBSS sempre que o driver é carregado pelo kernel e cancela o registro com RDBSS quando o driver é descarregado. Esse processo de registro é um aperto de mão bidirecional no qual o minidiretório de rede informa ao RDBSS que ele foi carregado chamando RxRegisterMinirdr, a rotina de registro exportada do RDBSS. O RDBSS conclui o processo de registro e inicialização chamando MrxStart, uma das rotinas de retorno de chamada exportadas pelo minidiretório de rede e passadas como parte da tabela de expedição para RxRegisterMinirdr.

Um dos parâmetros passados para a rotina RxRegisterMinirdr indica se o minidiretório de rede dá suporte a maillots. Um minidiretório de rede normalmente chamaria RxSetDomainForMailslotBroadcast da rotina MrxStart ou como parte de uma solicitação externa para iniciar o driver iniciado por um FSCTRL (controle do sistema de arquivos) ou uma solicitação de controle de E/S (IOCTL) de um aplicativo ou serviço no modo de usuário.