FsRtlLookupPerFileContext, fonction (ntifs.h)

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 fichier. 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 le 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 nonNULL si InstanceId n’est pasNULL.

[in, optional] InstanceId

Pointeur vers une variable allouée par le pilote de filtre qui peut être utilisée 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 de retour

Pointeur vers la première structure de FSRTL_PER_FILE_CONTEXT qui correspond au OwnerId et InstanceId, le cas échéant, ou NULL si aucune correspondance n’est trouvée ou si 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista
plateforme cible	Universel
d’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

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