Compartilhar via


Função RxpDereferenceNetFcb (fcb.h)

RxpDereferenceNetFcb diminui a contagem de referência em uma estrutura FCB.

Sintaxe

LONG RxpDereferenceNetFcb(
  PFCB Fcb
);

Parâmetros

Fcb

Um ponteiro para a estrutura FCB a ser desreferenciada.

Retornar valor

RxpDereferenceNetFcb retorna a contagem de referência final após a desreferência.

Comentários

A referência e a desreferenciamento de FCBs são diferentes daquelas das outras estruturas de dados devido ao recurso inserido na FCB. Isso implica que o chamador requer informações sobre o status do FCB (se ele foi finalizado ou não). Para finalizar o FCB, dois bloqueios precisam ser mantidos, o NET_ROOT o bloqueio da tabela de nomes, bem como o recurso FCB. Essas considerações levam a uma abordagem diferente na desreferência de FCBs. Consequentemente, RxpDereferenceNetFcb não tenta finalizar o FCB.

Várias macros são definidas em fcb.h para depuração que são a maneira preferencial de chamar essa rotina. Essas macros fornecem um wrapper em torno das rotinas RxpReferenceNetFcb ou RxpDereferenceNetFcb usadas para operações de gerenciamento de estrutura de arquivos em estruturas FCB. A macro RxDereferenceNetFcb é a maneira preferencial de chamar essa rotina. Essa macro primeiro chama a rotina RxpTrackDereference para registrar informações de diagnóstico sobre a solicitação antes de chamar a rotina RxpDereferenceNetFcb .

Em builds verificados, RxpDereferenceNetFcb fará com que o sistema assert se o tipo de nó para a estrutura não for um FCB ou se a contagem de referência final for menor que 0.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho fcb.h (inclua Fcb.h)
IRQL <= APC_LEVEL

Confira também

RxpReferenceNetFcb

RxpTrackDereference

RxpTrackReference

A estrutura FCB