Función FltGetFileContext (fltkernel.h)
La rutina fltGetFileContext de recupera un contexto establecido 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 necesario y no se puede null.
[in] FileObject
Puntero de objeto de archivo para el archivo. Este parámetro es necesario y no se puede 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 necesario 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 establezca Context en NULL_CONTEXT. Se trata de un código de error. |
| STATUS_NOT_SUPPORTED | Los contextos de archivo no se admiten para este archivo. Se trata de un código de error. |
Observaciones
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 de. 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 | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista |
| de la plataforma de destino de | Universal |
| encabezado de | fltkernel.h (incluya Fltkernel.h) |
| biblioteca de | FltMgr.lib |
| DLL de | Fltmgr.sys |
| irQL | <= APC_LEVEL |