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 |