Condividi tramite

Funzione FsRtlInsertPerFileContext (ntifs.h)

  • Articolo

La routine FsRtlInsertPerFileContext associa un oggetto FSRTL_PER_FILE_CONTEXT a un oggetto contesto specificato dal driver per un file.

Sintassi

NTSTATUS FsRtlInsertPerFileContext(
  [in] PVOID                   *PerFileContextPointer,
  [in] PFSRTL_PER_FILE_CONTEXT Ptr
);

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] Ptr

Puntatore alla struttura del contesto specifica del driver.

Valore restituito

La routine FsRtlInsertPerFileContext restituisce STATUS_SUCCESS o un codice di errore appropriato, ad esempio:

Codice restituito Descrizione
STATUS_INVALID_DEVICE_REQUEST
 Il file system sottostante non supporta i contesti di file di filtro. È possibile usare la macro FsRtlSupportsPerFileContexts per verificare se un file system supporta gli oggetti contesto di file.
STATUS_INSUFFICIENT_RESOURCES
 Il sistema non è riuscito ad allocare risorse (in genere memoria).

Osservazioni

La macro FsRtlGetPerFileContextPointer restituisce un FileContextSupportPointer per un file aperto.

Parametri

FileObject

FILE_OBJECT

Puntatore a un oggetto file.

Valore restituito

PVOID

La macro FsRtlGetPerFileContextPointer restituisce un puntatore opaco utilizzato dal pacchetto FSRTL (File System Runtime Library) per tenere traccia dei contesti di file. La macro restituisce NULL se il file system non supporta l'uso di oggetti contesto per file con file.

La macro FsRtlGetPerFileContextPointer restituisce il puntatore da passare alle routine, ad esempio FsRtlInsertPerFileContext, FsRtlLookupPerFileContexte FsRtlRemovePerFileContext.

Per altre informazioni su come usare e creare oggetti contesto, vedere Per-File Context in a Legacy File System Filter Driver.

Fabbisogno

Requisito Valore
client minimo supportato Windows Vista
piattaforma di destinazione Universale
intestazione ntifs.h (include FltKernel.h, Ntifs.h)
libreria NtosKrnl.lib
dll NtosKrnl.exe
IRQL <=APC_LEVEL

Vedere anche

FSRTL_PER_FILE_CONTEXT

FsRtlLookupPerFileContext

FsRtlRemovePerFileContext

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