Função FilterFindNext (fltuser.h)

Artigo
02/28/2024

A função FilterFindNext continua uma pesquisa de filtro iniciada por uma chamada para FilterFindFirst.

Sintaxe

HRESULT FilterFindNext(
  [in]  HANDLE                   hFilterFind,
  [in]  FILTER_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                   lpBuffer,
  [in]  DWORD                    dwBufferSize,
  [out] LPDWORD                  lpBytesReturned
);

Parâmetros

[in] hFilterFind

Identificador de pesquisa de filtro retornado por uma chamada anterior para FilterFindFirst.

[in] dwInformationClass

Tipo de informação solicitada. Esse parâmetro deve usar um dos valores a seguir.

Valor	Significado
FilterFullInformation	O buffer apontado pelo parâmetro lpBuffer recebe uma estrutura FILTER_FULL_INFORMATION para cada instância de minifiltro. Os filtros herdados são ignorados.
FilterAggregateBasicInformation	O buffer apontado pelo parâmetro lpBuffer recebe uma estrutura FILTER_AGGREGATE_BASIC_INFORMATION para cada instância de minifiltro ou filtro herdado. Esse valor dwInformationClass está disponível a partir do Microsoft Windows Server 2003 com SP1 e Windows XP com SP2 com rollup do gerenciador de filtros. Para obter mais informações sobre o pacote cumulativo cumulativo do gerenciador de filtros para Windows XP com SP2, consulte o artigo 914882: " O pacote cumulativo de rollup do gerenciador de filtros para Windows XP SP2", na Base de Dados de Conhecimento da Microsoft.
FilterAggregateStandardInformation	O buffer apontado pelo parâmetro lpBuffer recebe uma estrutura FILTER_AGGREGATE_STANDARD_INFORMATION para cada instância de minifiltro ou filtro herdado. Esse valor dwInformationClass está disponível a partir do Windows Vista.

[out] lpBuffer

Ponteiro para um buffer alocado pelo chamador que recebe as informações solicitadas. O tipo das informações retornadas é definido pelo parâmetro dwInformationClass .

[in] dwBufferSize

Tamanho, em bytes, do buffer para o qual o parâmetro lpBuffer aponta. O chamador deve definir esse parâmetro de acordo com o dwInformationClass especificado.

[out] lpBytesReturned

Ponteiro para uma variável alocada pelo chamador que recebe o número de bytes retornados no buffer para o qual lpBuffer aponta se a chamada para FilterFindNext for bem-sucedida. Esse parâmetro é necessário e não pode ser NULL.

Retornar valor

FilterFindNext retornará S_OK se tiver êxito. Caso contrário, ele retornará um valor de erro HRESULT, como um dos seguintes:

Código de retorno	Descrição
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	O buffer apontado por lpBuffer não é grande o suficiente para conter as informações solicitadas. Quando esse valor for retornado, lpBytesReturned conterá o tamanho, em bytes, do buffer necessário para a estrutura dwInformationClass fornecida.
HRESULT_FROM_WIN32(ERROR_INVALID_PARAMETER)	Um valor inválido foi especificado para o parâmetro dwInformationClass . Por exemplo, se FilterAggregateStandardInformation for especificado para um sistema operacional antes do Windows Vista, FilterFindNext retornará esse valor HRESULT.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)	Não foram encontrados mais drivers de filtro na lista global de drivers de filtro registrados.

Comentários

Depois que o identificador de pesquisa de filtro for estabelecido chamando FilterFindFirst, use a função FilterFindNext para pesquisar filtros adicionais na lista global de filtros registrados.

FilterFindNext localiza um driver de filtro (instância do driver de minifiltro ou driver de filtro herdado) por chamada.

A partir do Microsoft Windows Server 2003 com SP1 e Microsoft Windows XP com SP2 com rollup do gerenciador de filtros, FilterFindFirst e FilterFindNext podem fornecer informações herdadas do driver de filtro e informações de instância do driver de minifiltro. Em versões anteriores do Windows, FilterFindFirst e FilterFindNext só podem fornecer informações sobre minifiltros (consulte a descrição do parâmetro dwInformationClass acima).

FilterFindFirst e FilterFindNext retornam informações sobre drivers de filtro para diminuir a distância do sistema de arquivos base. As informações sobre o filtro mais distante do sistema de arquivos base são retornadas primeiro. As informações sobre o segundo filtro mais distante são retornadas em segundo lugar. As informações sobre o filtro mais próximo do sistema de arquivos base são retornadas por último.