Função FltCloseSectionForDataScan (fltkernel.h)

  • Artigo

A rotina FltCloseSectionForDataScan fecha um objeto de seção associado a um fluxo de arquivos.

Sintaxe

NTSTATUS FLTAPI FltCloseSectionForDataScan(
  [in] PFLT_CONTEXT SectionContext
);

Parâmetros

[in] SectionContext

Um ponteiro para o contexto da seção a ser fechado.

Retornar valor

FltCloseSectionForDataScan retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes.

Código de retorno Descrição
STATUS_INVALID_PARAMETER
 O contexto da seção não foi criado corretamente. Um contexto de seção alocado deve primeiro ser passado para FltCreateSectionForDataScan. Este é um código de erro.
STATUS_NOT_FOUND
 O contexto da seção já está fechado.

Comentários

Os minifiltros usam a rotina FltCloseSectionForDataScan para desalocar e remover um contexto de seção de um objeto de arquivo. Todos os contextos de seção alocados anteriormente passados para FltCreateSectionForDataScan devem ser passados para FltCloseSectionForDataScan. Caso contrário, os minifiltros poderão chamar FltReleaseContext se o contexto da seção foi alocado com FltAllocateContext , mas nenhuma seção foi criada com FltCreateSectionForDataScan.

Depois que FltCloseSectionForDataScan retornar, as operações que entram em conflito com a seção descrita por SectionContext não serão sincronizadas pelo gerenciador de filtros.

Requisitos

Requisito Valor
Cliente mínimo com suporte A rotina FltCloseSectionForDataScan está disponível a partir do Windows 8.
Plataforma de Destino Universal
Cabeçalho fltkernel.h (inclua Fltkernel.h)
Biblioteca FltMgr.lib
IRQL <= APC_LEVEL

Confira também

FltAllocateContext

FltCreateSectionForDataScan

FltDeleteContext