Compartir a través de

Función FsRtlInsertPerFileContext (ntifs.h)

  • Artículo

La rutina de FsRtlInsertPerFileCon text asocia un objeto FSRTL_PER_FILE_CONTEXT con un objeto de contexto especificado por el controlador para un archivo.

Sintaxis

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

Parámetros

[in] PerFileContextPointer

Puntero a un puntero opaco usado por el paquete de la biblioteca en tiempo de ejecución del sistema de archivos (FSRTL) para realizar un seguimiento de los contextos de archivo. Para recuperar este puntero de un objeto de archivo, use la macro FsRtlGetPerFileContextPointer.

[in] Ptr

Puntero a la estructura de contexto específica del controlador.

Valor devuelto

La rutina de FsRtlInsertPerFileContext devuelve STATUS_SUCCESS o un código de error adecuado, como:

Código devuelto Descripción
STATUS_INVALID_DEVICE_REQUEST
 El sistema de archivos subyacente no admite contextos de archivo de filtro. Puede usar la macro FsRtlSupportsPerFileContexts para comprobar si un sistema de archivos admite objetos de contexto de archivo.
STATUS_INSUFFICIENT_RESOURCES
 El sistema no pudo asignar recursos (normalmente memoria).

Observaciones

La macro FsRtlGetPerFileContextPointer devuelve un FileContextSupportPointer para un archivo abierto.

Parámetros

FileObject de

FILE_OBJECT

Puntero a un objeto de archivo.

Valor devuelto

PVOID

La macro FsRtlGetPerFileContextPointer devuelve un puntero opaco usado por el paquete de la biblioteca en tiempo de ejecución del sistema de archivos (FSRTL) para realizar un seguimiento de los contextos de archivo. La macro devuelve NULL si el sistema de archivos no admite el uso de objetos de contexto por archivo con archivos.

La macro FsRtlGetPerFileContextPointer devuelve el puntero que se pasará a rutinas como FsRtlInsertPerFileContext, FsRtlLookupPerFileContexty FsRtlRemovePerFileContext.

Para obtener más información sobre cómo usar y crear objetos de contexto, vea Tracking Per-File Context in a Legacy File System Filter Driver.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista
de la plataforma de destino de Universal
encabezado de ntifs.h (include FltKernel.h, Ntifs.h)
biblioteca de NtosKrnl.lib
DLL de NtosKrnl.exe
irQL <=APC_LEVEL

Consulte también

FSRTL_PER_FILE_CONTEXT

FsRtlLookupPerFileContext

FsRtlRemovePerFileContext

contexto de Per-File de seguimiento en un controlador de filtro del sistema de archivos heredado