Função RxCreateVNetRoot (fcb.h)

Artigo
02/29/2024

RxCreateVNetRoot aloca e inicializa uma estrutura NET_ROOT e insere o nome na tabela net name no objeto de dispositivo associado.

Sintaxe

PV_NET_ROOT RxCreateVNetRoot(
  [in] IN PRX_CONTEXT       RxContext,
  [in] IN PNET_ROOT         NetRoot,
  [in] IN PUNICODE_STRING   CanonicalName,
  [in] IN PUNICODE_STRING   LocalNetRootName,
  [in] IN PUNICODE_STRING   FilePath,
  [in] IN PRX_CONNECTION_ID RxConnectionId
);

Parâmetros

[in] RxContext

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

[in] NetRoot

Um ponteiro para a estrutura de NET_ROOT associada.

[in] CanonicalName

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

[in] LocalNetRootName

Um ponteiro para o nome NET_ROOT local sem o nome do prefixo.

[in] FilePath

Um ponteiro para um nome de caminho de arquivo. Esse parâmetro não é usado no momento e pode ser NULL.

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

Retornar valor

RxCreateVNetRoot retorna um ponteiro para uma estrutura de dados V_NET_ROOT recém-criada com êxito ou um ponteiro NULL sobre falha.

Comentários

A rotina RxCreateVNetRoot 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 V_NET_ROOT 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 RxCreateVNetRoot, um bloqueio na tabela de nomes associada ao membro do objeto do dispositivo do parâmetro RxContext deve ser adquirido no modo exclusivo.

RxCreateVNetRoot define uma variedade de parâmetros de contexto de segurança na estrutura V_NET_ROOT com base em parâmetros do RX_CONTEXT. Esses parâmetros incluem o seguinte: LogonId, SessionId, pUserName, pUserDomainName, pPassword e Flags.