Função RxCreateSrvCall (fcb.h)

RxCreateSrvCall cria uma estrutura SRV_CALL e insere o nome na tabela de nomes de rede mantida pelo RDBSS.

Sintaxe

PSRV_CALL RxCreateSrvCall(
  [in] IN PRX_CONTEXT       RxContext,
  [in] IN PUNICODE_STRING   Name,
       IN PUNICODE_STRING   InnerNamePrefix,
  [in] IN PRX_CONNECTION_ID RxConnectionId
);

Parâmetros

[in] RxContext

Um ponteiro para a estrutura RX_CONTEXT que contém o IRP que descreve uma operação de criação.

[in] Name

Um ponteiro para o nome a ser inserido na tabela de nomes.

InnerNamePrefix

[in] RxConnectionId

Um ponteiro para a ID de conexão a ser associada ao nome a ser inserido na tabela de nomes de prefixo. Esse parâmetro pode ser NULL , caso em que nenhuma ID de conexão será associada ao nome inserido na tabela de nomes de prefixo.

Valor retornado

RxCreateSrvCall retorna um ponteiro para uma estrutura de dados SRV_CALL recém-criada sobre o êxito ou um ponteiro NULL sobre falha.

Comentários

A rotina RxCreateSrvCall normalmente não é chamada por drivers de minidiretório de rede diretamente. O RDBSS chama essa rotina internamente quando um pacote de solicitação de E/S é recebido para IRP_MJ_CREATE e um SRV_CALL precisa ser criado. Esse IRP normalmente é recebido pelo RDBSS em resposta a um aplicativo no modo de usuário solicitando uma operação de criação de arquivo em um compartilhamento de rede. Também é possível que outro driver de kernel emita tal IRP.

Antes de chamar RxCreateSrvCall, um bloqueio na tabela de nomes associada ao membro do objeto do dispositivo do parâmetro RxContext deve ser adquirido no modo exclusivo.

RxCreateSrvCall inicializa os parâmetros de chamada de servidor passados por meio de atributos estendidos como parte da estrutura de RX_CONTEXT associada. Atualmente, isso inclui a inicialização do membro pPrincipalName do SRV_CALL que é passado pelo driver DFS.

Requisitos

   
Plataforma de Destino Área de Trabalho
Cabeçalho fcb.h (include Rxcontx.h, Mrxfcb.h, Prefix.h, Fcb.h)
IRQL <= APC_LEVEL

Confira também

RX_CONTEXT

RxCreateNetFcb

RxCreateNetFobx

RxCreateNetRoot

RxCreateSrvOpen

RxCreateVNetRoot

RxDereference

RxFinalizeConnection

RxFinalizeNetFcb

RxFinalizeNetFobx

RxFinalizeNetRoot

RxFinalizeSrvCall

RxFinalizeSrvOpen

RxFinalizeVNetRoot

RxFinishFcbInitialization

RxForceFinalizeAllVNetRoots

RxReference

RxSetSrvCallDomainName

RxpDereferenceNetFcb

RxpReferenceNetFcb

A estrutura SRV_CALL