Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La rutina FltQueryInformationByName devuelve la información solicitada sobre un archivo con nombre.
Sintaxis
NTSTATUS FLTAPI FltQueryInformationByName(
[in] PFLT_FILTER Filter,
[in, optional] PFLT_INSTANCE Instance,
[in] POBJECT_ATTRIBUTES ObjectAttributes,
[out] PIO_STATUS_BLOCK IoStatusBlock,
[out] PVOID FileInformation,
[in] ULONG Length,
[in] FILE_INFORMATION_CLASS FileInformationClass,
[in, optional] PIO_DRIVER_CREATE_CONTEXT DriverContext
);
Parámetros
[in] Filter
Especifica el filtro que está iniciando esta operación.
[in, optional] Instance
Especifica la instancia a la que se dirige la creación.
Importante
instancia no es necesariamente la instancia inicial. Debe coincidir con la instancia a la que se dirige la creación, si este parámetro no esNULL. Si instancia no esNULL, no se llama a la devolución de llamada de creación previa del filtro actual. Las devoluciones de llamada previas comienzan con el filtro debajo del filtro actual.
[in] ObjectAttributes
Puntero a una estructura [OBJECT_ATTRIBUTES] con los atributos que se usarán para el objeto de archivo (por ejemplo, su nombre, SECURITY_DESCRIPTOR, etc.).
[out] IoStatusBlock
Puntero a una estructura de IO_STATUS_BLOCK que contiene el bloque de estado de E/S del autor de la llamada.
[out] FileInformation
Puntero a una estructura que recibe la información solicitada devuelta sobre el archivo. El tipo de estructura viene determinado por FileInformationClass.
[in] Length
Longitud, en bytes, del búfer de FileInformation.
[in] FileInformationClass
Valor de enumeración FILE_INFORMATION_CLASS que especifica el tipo de información que se va a devolver sobre el archivo. Puede ser uno de los siguientes valores:
| Valor | Tipo de estructura a la que apunta FileInformation |
|---|---|
| FileStatInformation | FILE_STAT_INFORMATION |
| FileStatLxInformation | **FILE_STAT_LX_INFORMATION |
| FileCaseSensitiveInformation | FILE_CASE_SENSITIVE_INFORMATION. El autor de la llamada debe haber abierto el archivo con la marca FILE_READ_ATTRIBUTES especificada en el parámetro DesiredAccess. Este valor está disponible a partir de Windows 10, versión 1803. |
| FileCaseSensitiveInformationForceAccessCheck | FILE_CASE_SENSITIVE_INFORMATION. Se trata de una versión especial de la operación FileCaseSensitiveInformation que se usa para forzar al Administrador de E/S a realizar comprobaciones de acceso para el controlador en modo kernel, similar a las comprobaciones que se aplican a un llamador en modo de usuario. El Administrador de E/S solo reconoce esta operación y un sistema de archivos nunca debe recibirla. Este valor está disponible a partir de Windows 10, versión 1803. |
[in, optional] DriverContext
Puntero al espacio de contexto del controlador.
Valor devuelto
Devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, devuelve un código de error NTSTATUS adecuado.
Observaciones
Esta función devuelve información solicitada sobre un archivo sin abrir el archivo real. La información devuelta viene determinada por el FileInformationClass que se especifica y se coloca en el búfer FileInformation del autor de la llamada.
Si instancia no esNULL, la creación se dirige a la instancia especificada, llamando a todos los filtros debajo del filtro actual antes de enviar la E/S hacia abajo. Si instancia es null, la E/S siempre se enviará a la parte superior de la pila de filtros.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10, versión 1706 |
| encabezado de | fltkernel.h |
| biblioteca de | FltMgr.lib |
| DLL de | Fltmgr.sys |