Función FltGetFileContext (fltkernel.h)
La rutina FltGetFileContext recupera un contexto que se estableció para un archivo mediante una instancia de controlador de minifiltro determinada.
Sintaxis
NTSTATUS FLTAPI FltGetFileContext(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[out] PFLT_CONTEXT *Context
);
Parámetros
[in] Instance
Puntero de instancia opaco para el autor de la llamada. Este parámetro es obligatorio y no puede ser NULL.
[in] FileObject
Puntero de objeto de archivo para el archivo. Este parámetro es obligatorio y no puede ser NULL.
[out] Context
Puntero a una variable asignada por el autor de la llamada que recibe la dirección del contexto. Este parámetro es obligatorio y no se puede establecer en NULL.
Valor devuelto
FltGetFileContext devuelve STATUS_SUCCESS cuando devuelve correctamente el contexto de archivo solicitado. De lo contrario, devuelve un valor NTSTATUS adecuado, como uno de los siguientes:
| Código devuelto | Descripción |
|---|---|
| STATUS_NOT_FOUND | No se encontró ningún contexto coincidente en este archivo en este momento, por lo que FltMgr estableció Context en NULL_CONTEXT. Se trata de un código de error. |
| STATUS_NOT_SUPPORTED | No se admiten contextos de archivo para este archivo. Se trata de un código de error. |
Comentarios
Para obtener más información sobre los contextos, vea Acerca de los contextos de minifiltro.
Un controlador de minifiltro llama a FltGetFileContext para recuperar el contexto de archivo que ha establecido para un archivo determinado.
FltGetFileContext incrementa el recuento de referencias en el contexto al que apunta el parámetro Context . Cuando este puntero de contexto ya no es necesario, el autor de la llamada debe disminuir su recuento de referencias llamando a FltReleaseContext. Por lo tanto, cada llamada correcta a FltGetFileContext debe coincidir con una llamada posterior a FltReleaseContext.
Para establecer un contexto de archivo, llame a FltSetFileContext.
Para asignar un nuevo contexto, llame a FltAllocateContext.
Para eliminar un contexto de archivo, llame a FltDeleteFileContext o FltDeleteContext.
Para determinar si se admiten contextos de archivo para un archivo determinado, llame a FltSupportsFileContexts o FltSupportsFileContextsEx.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Plataforma de destino | Universal |
| Encabezado | fltkernel.h (incluya Fltkernel.h) |
| Library | FltMgr.lib |
| Archivo DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |