Função RxCreateNetFobx (fcb.h)

Artigo
02/06/2025

RxCreateNetFobx aloca, inicializa e insere uma nova estrutura de FOBX (extensão de objeto de arquivo) nas estruturas de dados na memória de uma FCB na qual esse FOBX está sendo aberto.

Sintaxe

PMRX_FOBX RxCreateNetFobx(
  [out] OUT PRX_CONTEXT  RxContext,
  [in]  IN PMRX_SRV_OPEN MrxSrvOpen
);

Parâmetros

[out] RxContext

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

[in] MrxSrvOpen

Um ponteiro para a estrutura de SRV_OPEN associada.

Valor de retorno

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

Observações

Os minidiretórios de rede devem chamar RxCreateNetFobx para criar um FOBX no final de uma operação de criação bem-sucedida.

Antes de chamar RxCreateNetFobx, o FCB associado à estrutura FOBX deve ser adquirido no modo exclusivo.

RxCreateNetFobx tentará usar o FOBX alocado como parte da estrutura fcb associada se estiver disponível. Se o FOBX alocado com o FCB não estiver disponível, RxCreateNetFobx tentará usar o FOBX alocado como parte da estrutura de SRV_OPEN associada se estiver disponível. Em qualquer um desses casos, RxCreateNetFobx só precisa inicializar a estrutura FOBX existente, nenhuma alocação de memória é necessária. Se ambas as estruturas FOBX no FCB associado e SRV_OPEN estrutura não estiverem disponíveis, RxCreateNetFobx alocará uma nova estrutura FOBX.

Se o FCB associado for um arquivo de paginação, RxCreateNetFobx alocará memória de pool não paged ao criar a nova estrutura de dados FOBX. Se o FCB associado não for um arquivo de paginação, RxCreateNetFobx alocará memória de pool de páginas ao criar a nova estrutura de dados FOBX.

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

Com êxito, os seguintes membros FOBX na estrutura FOBX são definidos:

O membro NodeReference está definido como 1.
O membro FobxSerialNumber está definido como 0.
O membro srvOpen é definido como a estrutura de SRV_OPEN associada.
O membro fOpenCountDecremented está definido como false.
O Flags membro é definido como um valor com base nos parâmetros do RX_CONTEXT e se um novo FOBX precisava ser alocado.

Com o êxito, a contagem de referência para a estrutura de SRV_OPEN é incrementada e o membro NumberOfFobxs na estrutura V_NET_ROOT associada é incrementado.