Funzione FsRtlLookupPerFileContext (ntifs.h)

La routine fsRtlLookupPerFileContext restituisce un puntatore a un oggetto FSRTL_PER_FILE_CONTEXT associato a un file specificato.

Sintassi

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

Parametri

[in] PerFileContextPointer

Puntatore a un puntatore opaco usato dal pacchetto FSRTL (File System Runtime Library) per tenere traccia dei contesti di file. Per recuperare questo puntatore da un oggetto file, utilizzare la macro FsRtlGetPerFileContextPointer.

[in, optional] OwnerId

Puntatore a una variabile allocata dal driver di filtro che identifica in modo univoco il proprietario della struttura del contesto per file. Il formato di questa variabile è specifico del driver di filtro. Questo parametro è facoltativo, ma deve essere diverso daNULL se InstanceId non èNULL.

[in, optional] InstanceId

Puntatore a una variabile allocata dal driver di filtro che può essere usata per distinguere tra le strutture di contesto per file create dallo stesso driver di filtro. Il formato di questa variabile è specifico del driver di filtro. Questo parametro è facoltativo.

Valore restituito

Puntatore alla prima struttura FSRTL_PER_FILE_CONTEXT che corrisponde al OwnerId e InstanceId, se specificato o NULL se non viene trovata alcuna corrispondenza o il file system non supporta contesti per file.

Osservazioni

Non specificando OwnerID e InstanceId, un driver di filtro può cercare il primo contesto associato a un file.

Se il file system non supporta oggetti contesto per file, viene restituito NULL. Utilizzare la macro FsRtlSupportsPerFileContexts per determinare se un file system supporta oggetti contesto per file.

Fabbisogno

Vedere anche

FSRTL_PER_FILE_CONTEXT

FsRtlGetPerFileContextPointer

FsRtlInsertPerFileContext

FsRtlRemovePerFileContext

contesto Per-File di rilevamento in un driver di filtro del file system legacy