Função RxCreateNetFobx (fcb.h)

Artigo
02/26/2024

RxCreateNetFobx aloca, inicializa e insere uma nova estrutura de FOBX (extensão de objeto de arquivo) nas estruturas de dados na memória de um FCB no 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.

Retornar valor

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

Comentários

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 paginada 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 paginada 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 é 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 membro Flags é definido como um valor com base nos parâmetros do RX_CONTEXT e se um novo FOBX precisava ser alocado.

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