Función FltSupportsFileContextsEx (fltkernel.h)
La rutina FltSupportsFileContextsEx determina si el sistema de archivos o el administrador de filtros admiten contextos de archivos para un archivo determinado.
Sintaxis
BOOLEAN FLTAPI FltSupportsFileContextsEx(
[in] PFILE_OBJECT FileObject,
[in, optional] PFLT_INSTANCE Instance
);
Parámetros
[in] FileObject
Puntero al objeto de archivo que representa el archivo cuya compatibilidad con el contexto de archivo se está consultando. Este parámetro es necesario y no se puede null.
[in, optional] Instance
Puntero de instancia opaco para el autor de la llamada. Este parámetro es opcional y se puede NULL. Para obtener más información sobre este parámetro, vea la sección Comentarios de esta página.
Valor devuelto
FltSupportsFileContextsEx devuelve TRUE si el sistema de archivos o el administrador de filtros admite contextos de archivo para el archivo; false de lo contrario.
Observaciones
Los controladores de minifiltro pueden llamar a la rutina de FltSupportsFileContextsEx para determinar si el sistema de archivos subyacente o el administrador de filtros admite contextos de archivo para el archivo representado por FileObject sin tener que asignar un contexto e intentar establecerlo. Si no se admite un tipo de contexto en un archivo, el minifiltro no puede adjuntar un contexto a ese archivo.
En el caso de los sistemas de archivos (como FAT) que solo admiten un único flujo de datos por archivo, los contextos de archivo son equivalentes a los contextos de secuencia. Estos sistemas de archivos suelen admitir contextos de secuencia, pero no admiten contextos de archivo. En su lugar, el administrador de filtros proporciona compatibilidad con el contexto de archivo, mediante la compatibilidad existente del sistema de archivos para los contextos de secuencia. En el caso de las instancias de minifiltro asociadas a estos sistemas de archivos, FltSupportsFileContexts devuelve FALSE, mientras que FltSupportsFileContextsEx devuelve TRUE (cuando se pasa un valorNULL no válido para el parámetro Instance válido).
Si se proporciona un valor deNULL no NULL para el parámetro instance de, FltSupportsFileContextsEx devuelve TRUE si el sistema de archivos o el administrador de filtros admite contextos de archivo para el archivo; false de lo contrario.
Si el parámetro instance es NULL, FltSupportsFileContextsEx devuelve TRUE solo si el sistema de archivos admite contextos de archivo para el archivo. De lo contrario, devuelve FALSE, incluso si el administrador de filtros admite contextos de archivo para el archivo.
Tenga en cuenta que un sistema de archivos puede admitir contextos de archivos para algunos tipos de archivos, pero no para otros. Por ejemplo, NTFS y FAT no admiten contextos de archivo para los archivos de paginación.
Para obtener más información sobre los contextos, vea Acerca de los contextos de minifiltro.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Esta rutina está disponible en Windows Vista y versiones posteriores. |
| 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 |