Função RxSetSrvCallDomainName (rxprocs.h)
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 |
|---|---|
|
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 |