Función FltGetFilterFromName (fltkernel.h)

Artículo
02/26/2024

La rutina FltGetFilterFromName devuelve un puntero de filtro opaco para un controlador de minifiltro registrado cuyo nombre coincide con el valor del parámetro FilterName .

Sintaxis

NTSTATUS FLTAPI FltGetFilterFromName(
  [in]  PCUNICODE_STRING FilterName,
  [out] PFLT_FILTER      *RetFilter
);

Parámetros

[in] FilterName

Puntero a una estructura de UNICODE_STRING que contiene el nombre del controlador de minifiltro. (La comparación de nombres no distingue mayúsculas de minúsculas).

[out] RetFilter

Puntero a una variable asignada por el autor de la llamada que recibe un puntero de filtro opaco para el controlador de minifiltro cuyo nombre coincide con el nombre en el parámetro FilterName . Este parámetro es obligatorio y no puede ser NULL.

Valor devuelto

FltGetFilterFromName devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como uno de los siguientes:

Código devuelto	Descripción
STATUS_FLT_DELETING_OBJECT	Se encontró un controlador de minifiltro coincidente, pero se está desgarrando. Se trata de un código de error.
STATUS_FLT_FILTER_NOT_FOUND	No se encontró ningún controlador de minifiltro coincidente. Se trata de un código de error.

Comentarios

FltGetFilterFromName agrega una referencia de rundown al puntero de filtro opaco devuelto en el parámetro RetFilter . Cuando este puntero ya no es necesario, el autor de la llamada debe liberarlo llamando a FltObjectDereference. Por lo tanto, cada llamada correcta a FltGetFilterFromName debe coincidir con una llamada posterior a FltObjectDereference.

Para registrar un controlador de minifiltro con el Administrador de filtros, llame a FltRegisterFilter.