Função RxCreateSrvCall (fcb.h)

Artigo
11/14/2023

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

Sintaxe

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

Parâmetros

RxContext

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

Name

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

InnerNamePrefix

Um ponteiro para um nome de prefixo interno opcional a ser inserido na tabela de nomes com o Nome.

RxConnectionId

[in] 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.

Retornar valor

RxCreateSrvCall retorna um ponteiro para uma estrutura de dados SRV_CALL recém-criada com ê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 esse 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.