Fonction FsRtlLookupPerFileContext (ntifs.h)

  • Article

La routine FsRtlLookupPerFileContext retourne un pointeur vers un objet FSRTL_PER_FILE_CONTEXT associé à un fichier spécifié.

Syntaxe

PFSRTL_PER_FILE_CONTEXT FsRtlLookupPerFileContext(
  [in]           PVOID *PerFileContextPointer,
  [in, optional] PVOID OwnerId,
  [in, optional] PVOID InstanceId
);

Paramètres

[in] PerFileContextPointer

Pointeur vers un pointeur opaque utilisé par le package FSRTL (File System Runtime Library) pour suivre les contextes de fichiers. Pour récupérer ce pointeur à partir d’un objet de fichier, utilisez la macro FsRtlGetPerFileContextPointer .

[in, optional] OwnerId

Pointeur vers une variable allouée par un pilote de filtre qui identifie de manière unique le propriétaire de la structure de contexte par fichier. Le format de cette variable est spécifique au pilote de filtre. Ce paramètre est facultatif, mais doit être non NULL si InstanceId n’est pas NULL.

[in, optional] InstanceId

Pointeur vers une variable allouée par un pilote de filtre qui peut être utilisé pour distinguer les structures de contexte par fichier créées par le même pilote de filtre. Le format de cette variable est spécifique au pilote de filtre. Ce paramètre est facultatif.

Valeur renvoyée

Pointeur vers la première structure FSRTL_PER_FILE_CONTEXT qui correspond à OwnerId et InstanceId, si spécifié, ou NULL si aucune correspondance n’est trouvée ou le système de fichiers ne prend pas en charge les contextes par fichier.

Remarques

En ne spécifiant pas OwnerID et InstanceId, un pilote de filtre peut rechercher le premier contexte associé à un fichier.

Si le système de fichiers ne prend pas en charge les objets de contexte par fichier, null est retourné. Utilisez la macro FsRtlSupportsPerFileContexts pour déterminer si un système de fichiers prend en charge les objets de contexte par fichier.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Plateforme cible Universal
En-tête ntifs.h (include FltKernel.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Voir aussi

FSRTL_PER_FILE_CONTEXT

FsRtlGetPerFileContextPointer

FsRtlInsertPerFileContext

FsRtlRemovePerFileContext

Suivi Per-File contexte dans un pilote de filtre de système de fichiers hérité