Função FilterInstanceCreate (fltuser.h)
A função FilterInstanceCreate cria um identificador que pode ser usado para se comunicar com a instância de minifiltro fornecida.
Sintaxe
HRESULT FilterInstanceCreate(
[in] LPCWSTR lpFilterName,
[in] LPCWSTR lpVolumeName,
[in, optional] LPCWSTR lpInstanceName,
[out] HFILTER_INSTANCE *hInstance
);
Parâmetros
[in] lpFilterName
Ponteiro para uma cadeia de caracteres largos terminada em nulo que contém o nome do minifiltro que possui a instância.
[in] lpVolumeName
Ponteiro para uma cadeia de caracteres largos terminada em nulo que contém o nome do volume ao qual a instância está anexada.
A cadeia de caracteres de entrada lpVolumeName pode ser qualquer uma das seguintes. A barra invertida à direita (\) é opcional.
- Uma letra da unidade, como "D:\"
- Um caminho para um ponto de montagem de volume, como "c:\mnt\edrive\"
- Um identificador de volume exclusivo (também chamado de nome GUID do volume), como "\?? \Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
- Um nome de dispositivo não persistente (também chamado de nome de destino ou nome de dispositivo NT), como "\Device\HarddiskVolume1\"
[in, optional] lpInstanceName
Ponteiro para uma cadeia de caracteres largos terminada em nulo que contém o nome da instância da instância. Esse parâmetro é opcional e pode ser NULL. Se for NULL, a primeira instância encontrada para esse minifiltro nesse volume será retornada.
[out] hInstance
Ponteiro para uma variável alocada pelo chamador que recebe um identificador opaco para a instância de minifiltro se a chamada para FilterInstanceCreate for bem-sucedida; caso contrário, ele receberá INVALID_HANDLE_VALUE.
Retornar valor
FilterInstanceCreate retornará S_OK se tiver êxito. Caso contrário, ele retornará um valor de erro.
Comentários
Um aplicativo de modo de usuário chama FilterInstanceCreate para criar um identificador que pode ser usado para se comunicar com uma instância de minifiltro no modo kernel. O identificador de instância retornado pode ser passado como um parâmetro para funções como FilterInstanceGetInformation.
Para fechar um identificador de instância retornado por FilterInstanceCreate, chame FilterInstanceClose.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Cabeçalho | fltuser.h (inclua Fltuser.h) |
| Biblioteca | FltLib.lib |
| DLL | FltLib.dll |