Función FltSupportsFileContextsEx (fltkernel.h)

La rutina FltSupportsFileContextsEx determina si el sistema de archivos o el administrador de filtros admiten contextos de archivo 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 obligatorio y no puede ser NULL.

[in, optional] Instance

Puntero de instancia opaco para el autor de la llamada. Este parámetro es opcional y puede ser 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 en caso contrario.

Comentarios

Los controladores de minifiltro pueden llamar a la rutina 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 flujo. Estos sistemas de archivos suelen admitir contextos de flujo, 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 flujo. En el caso de las instancias de minifiltro adjuntas a estos sistemas de archivos, FltSupportsFileContexts devuelve FALSE, mientras que FltSupportsFileContextsEx devuelve TRUE (cuando se pasa un valor no NULL válido para el parámetro Instance ).

Si se proporciona un valor distinto de NULL para el parámetro Instance , FltSupportsFileContextsEx devuelve TRUE si el sistema de archivos o el administrador de filtros admite contextos de archivo para el archivo; False en caso 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 archivo para algunos tipos de archivos, pero no para otros. Por ejemplo, NTFS y FAT no admiten contextos de archivo para paginar archivos.

Para obtener más información sobre los contextos, vea Acerca de los contextos de minifiltro.

Requisitos

Consulte también

FltAllocateContext

FltDeleteContext

FltDeleteFileContext

FltGetFileContext

FltReleaseContext

FltSetFileContext

FltSupportsFileContexts