Função RxCreateNetFcb (fcb.h)

Artigo
02/06/2025

RxCreateNetFCB aloca, inicializa e insere uma nova estrutura FCB nas estruturas de dados na memória para um V_NET_ROOT em que este FCB está sendo aberto. A estrutura alocada tem espaço para um SRV_OPEN e uma estrutura FOBX.

Sintaxe

PFCB RxCreateNetFcb(
  [in] IN PRX_CONTEXT     RxContext,
  [in] IN PIRP            Irp,
  [in] IN PV_NET_ROOT     VNetRoot,
  [in] IN PUNICODE_STRING Name
);

Parâmetros

[in] RxContext

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

[in] Irp

Um ponteiro para o IRP encapsulado por essa estrutura de RX_CONTEXT.

[in] VNetRoot

Um ponteiro para a estrutura V_NET_ROOT na qual esta FCB está sendo aberta.

[in] Name

O nome da FCB. O V_NET_ROOT pode conter um prefixo de nome que deve ser acrescentado aqui.

Valor de retorno

RxCreateNetFCB retorna um ponteiro para uma estrutura de dados FCB recém-alocada com êxito ou um ponteiro de NULL sobre falha.

Observações

A rotina de RxCreateNetFCB do normalmente não é chamada por drivers de minidiretor de rede diretamente. O RDBSS chama essa rotina internamente quando um pacote de solicitação de E/S é recebido para IRP_MJ_CREATE e uma estrutura FCB precisa ser criada. 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.

Se a FCB a ser criada for um arquivo de paginação, RxCreateNetFCB alocará memória de pool não paged ao criar a nova estrutura de dados FCB e definirá o seguinte sinalizador no membro FcbState da FCB:

Se a FCB a ser criada não for um arquivo de paginação, RxCreateNetFCB alocará memória de pool de páginas ao criar a nova estrutura de dados FCB.

No momento, o Windows não permite ter um arquivo de paginação em um computador remoto.

Se o membro Create.Flags no RX_CONTEXT tiver o sinalizador de RX_CONTEXT_CREATE_FLAG_ADDEDBACKSLASH ativado, o fcbState membro da FCB terá o sinalizador FCB_STATE_ADDEDBACKSLASH ativado.