Função RxSetSrvCallDomainName (rxprocs.h)

  • Artigo

RxSetSrvCallDomainName é chamado por um driver de minidiretório de rede para definir o nome de domínio associado a qualquer servidor determinado (estrutura SRV_CALL).

Sintaxe

NTSTATUS RxSetSrvCallDomainName(
  [in] IN PMRX_SRV_CALL   SrvCall,
  [in] IN PUNICODE_STRING DomainName
);

Parâmetros

[in] SrvCall

Um ponteiro para a estrutura SRV_CALL.

[in] DomainName

Um ponteiro para um buffer que contém uma cadeia de caracteres Unicode terminada em zero que nomeia o domínio ao qual este servidor pertence.

Retornar valor

RxSetSrvCallDomainName 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 novo nome de domínio.

Comentários

O nome de domínio pode não ser conhecido no início de uma solicitação de redirecionamento de rede. A rotina RxSetSrvCallDomainName permite que o nome de domínio seja associado ao SrvCall assim que for conhecido. Normalmente, essa rotina seria usada como parte da criação e inicialização de uma estrutura de SRV_CALL.

Se um nome de domínio já estiver associado ao parâmetro SrvCall , esse nome de domínio será removido e a memória associada a essa entrada em SrvCall será liberada.

Se o parâmetro DomainName não for um ponteiro NULL e o parâmetro DomainName tiver um comprimento maior que zero, RxSetSrvCallDomainName alocará espaço para o membro pDomainName de SrvCall do pool nãopagado com uma marca de pool de RX_SRVCALL_PARAMS_POOLTAG. A rotina RxSetSrvCallDomainName define os membros buffer, length e MaximumLength da estrutura pDomainName .

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho rxprocs.h (inclua Mrxfcb.h, Rxprocs.h)
IRQL <= APC_LEVEL

Confira também

RxCreateSrvCall

RxFinalizeSrvCall