Função RxFinalizeNetFobx (fcb.h)

Artigo
02/06/2025

RxFinalizeNetFOBX finaliza a estrutura FOBX fornecida. O chamador deve ter um bloqueio exclusivo no FCB associado à estrutura FOBX.

Sintaxe

BOOLEAN RxFinalizeNetFobx(
  [out] OUT PFOBX  ThisFobx,
  [in]  IN BOOLEAN RecursiveFinalize,
  [in]  IN BOOLEAN ForceFinalize
);

Parâmetros

[out] ThisFobx

Um ponteiro para a estrutura FOBX a ser finalizada.

[in] RecursiveFinalize

O valor que indica se a finalização deve ser feita recursivamente. Esse parâmetro não é usado no momento.

[in] ForceFinalize

O valor que indica se a finalização deve ser forçada, independentemente da contagem de referência.

Se ForceFinalize for FALSE, o NodeReferenceCount membro da estrutura FOBX apontado pelo ThisFobx deverá ser 0 para que o FOBX seja finalizado.

Valor de retorno

RxFinalizeNetFOBX retornará TRUE no êxito ou FALSE se a finalização não ocorrer:

Observações

A rotina de RxFinalizeNetFOBX 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_CLOSE. Esse IRP normalmente é recebido pelo RDBSS em resposta a um aplicativo no modo de usuário solicitando uma operação de fechamento de arquivo. Também é possível que outro driver de kernel emita tal IRP.

Antes de chamar RxFinalizeNetFOBX, um bloqueio na estrutura FCB deve ser adquirido no modo exclusivo.

A rotina RxFinalizeNetFOBX chamará a rotina MRxDeallocateForFobx fornecida pelo minidiretório de rede para liberar a memória do FOBX se o minidiretório de rede der suporte a essa rotina.