Função RxSetDomainForMailslotBroadcast (mrx.h)
RxSetDomainForMailslotBroadcast é chamado por um driver de minidiretório de rede para definir o domínio usado para transmissões de emaillot se houver suporte para emailslots pelo 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 com término zero que nomeia o domínio a ser usado para emailslots.
Valor de retorno
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. |
Observações
Um minidiretor 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 de RxRegisterMinirdr indica se o minidiretor de rede dá suporte a emailslots. Um minidiretório de rede normalmente chama RxSetDomainForMailslotBroadcast da rotina do MrxStart ou como parte de uma solicitação externa para iniciar o driver iniciado por um FSCTRL (controle de sistema de arquivos) ou uma solicitação de CONTROLE de E/S (IOCTL) de um aplicativo ou serviço no modo de usuário.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | mrx.h (incluir Mrx.h) |
| IRQL | <= APC_LEVEL |