Función FilterCreate (fltuser.h)

La función FilterCreate crea un identificador para el minifiltro especificado.

Sintaxis

HRESULT FilterCreate(
  [in]  LPCWSTR lpFilterName,
  [out] HFILTER *hFilter
);

Parámetros

[in] lpFilterName

Puntero a una cadena de caracteres anchos terminada en NULL que contiene el nombre del minifiltro. Este parámetro es obligatorio y no puede ser NULL.

[out] hFilter

Puntero a una variable asignada por el autor de la llamada que recibe un identificador para el minifiltro si la llamada a FilterCreate se realiza correctamente; de lo contrario, recibe INVALID_HANDLE_VALUE.

Valor devuelto

FilterCreate devuelve S_OK si se ejecuta correctamente. De lo contrario, devuelve un valor de error.

Comentarios

Una aplicación en modo de usuario llama a FilterCreate para crear un identificador que se pueda usar para comunicarse con un minifiltro en modo kernel. El controlador de minifiltro devuelto se puede pasar como parámetro a funciones como FilterGetInformation.

Para cerrar un identificador de filtro devuelto por FilterCreate, llame a FilterClose.

Requisitos

Plataforma de destino	Universal
Encabezado	fltuser.h (incluya Fltuser.h)
Library	FltLib.lib
Archivo DLL	FltLib.dll

Consulte también

FilterClose

FilterGetInformation