Partager via


FltCloseSectionForDataScan, fonction (fltkernel.h)

La routine FltCloseSectionForDataScan ferme un objet de section associé à un flux de fichiers.

Syntaxe

NTSTATUS FLTAPI FltCloseSectionForDataScan(
  [in] PFLT_CONTEXT SectionContext
);

Paramètres

[in] SectionContext

Pointeur vers le contexte de section à fermer.

Valeur de retour

FltCloseSectionForDataScan retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple l’une des valeurs suivantes.

Retourner le code Description
STATUS_INVALID_PARAMETER
Le contexte de section n’a pas été correctement créé. Un contexte de section alloué doit d’abord être passé à FltCreateSectionForDataScan. Il s’agit d’un code d’erreur.
STATUS_NOT_FOUND
Le contexte de section est déjà fermé.

Remarques

Les minifiltres utilisent la routine FltCloseSectionForDataScan pour libérer et supprimer un contexte de section d’un objet de fichier. Tous les contextes de section précédemment alloués passés à FltCreateSectionForDataScan doivent être passés à FltCloseSectionForDataScan. Sinon, les minifilters peuvent appeler FltReleaseContext si le contexte de section a été alloué avec FltAllocateContext mais aucune section n’a été créée avec FltCreateSectionForDataScan.

Une fois FltCloseSectionForDataScan retourné, les opérations qui entrent en conflit avec la section décrite par SectionContext ne seront pas synchronisées par le gestionnaire de filtres.

Exigences

Exigence Valeur
client minimum pris en charge La routine FltCloseSectionForDataScan est disponible à partir de Windows 8.
plateforme cible Universel
d’en-tête fltkernel.h (include Fltkernel.h)
bibliothèque FltMgr.lib
IRQL <= APC_LEVEL

Voir aussi

FltAllocateContext

FltCreateSectionForDataScan

FltDeleteContext