Fonction FltCloseSectionForDataScan (fltkernel.h)

  • Article

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 retournée

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

Code de retour 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 fichier. Tous les contextes de section précédemment alloués passés à FltCreateSectionForDataScan doivent être passés à FltCloseSectionForDataScan. Sinon, les minifiltres peuvent appeler FltReleaseContext si le contexte de section a été alloué avec FltAllocateContext , mais qu’aucune section n’a été créée avec FltCreateSectionForDataScan.

Après le retour de FltCloseSectionForDataScan, les opérations en conflit avec la section décrite par SectionContext ne sont pas synchronisées par le gestionnaire de filtres.

Configuration requise

Condition requise Valeur
Client minimal pris en charge La routine FltCloseSectionForDataScan est disponible à partir de Windows 8.
Plateforme cible Universal
En-tête fltkernel.h (inclure Fltkernel.h)
Bibliothèque FltMgr.lib
IRQL <= APC_LEVEL

Voir aussi

FltAllocateContext

FltCreateSectionForDataScan

FltDeleteContext