Compartilhar via


Função FilterCreate (fltuser.h)

A função FilterCreate cria um identificador para o minifiltro especificado.

Sintaxe

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

Parâmetros

[in] lpFilterName

Ponteiro para uma cadeia de caracteres largos terminada em nulo que contém o nome do minifiltro. Esse parâmetro é necessário e não pode ser NULL.

[out] hFilter

Ponteiro para uma variável alocada pelo chamador que recebe um identificador para o minifiltro se a chamada para FilterCreate for bem-sucedida; caso contrário, ele receberá INVALID_HANDLE_VALUE.

Valor retornado

FilterCreate retornará S_OK se tiver êxito. Caso contrário, ele retornará um valor de erro.

Comentários

Um aplicativo no modo de usuário chama FilterCreate para criar um identificador que pode ser usado para se comunicar com um minifiltro no modo kernel. O identificador de minifiltro retornado pode ser passado como um parâmetro para funções como FilterGetInformation.

Para fechar um identificador de filtro retornado por FilterCreate, chame FilterClose.

Requisitos

   
Plataforma de Destino Universal
Cabeçalho fltuser.h (inclua Fltuser.h)
Biblioteca FltLib.lib
DLL FltLib.dll

Confira também

FilterClose

FilterGetInformation