Partilhar via


Método IHeaderCtrl2::SetColumnFilter (mmc.h)

O IHeaderCtrl2::SetColumnFilter define o valor do filtro e seu comprimento máximo de caractere para uma coluna especificada em uma lista filtrada.

Sintaxe

HRESULT SetColumnFilter(
  [in] UINT           nColumn,
  [in] DWORD          dwType,
  [in] MMC_FILTERDATA *pFilterData
);

Parâmetros

[in] nColumn

Um índice baseado em zero que identifica a coluna para a qual o valor do filtro e seu comprimento máximo de caractere devem ser definidos.

[in] dwType

Tipo de filtro a ser aplicado à coluna especificada, obtida da enumeração MMC_FILTER_TYPE .

[in] pFilterData

Um ponteiro para uma estrutura MMC_FILTERDATA que contém os dados de filtro reais.

Retornar valor

Esse método pode retornar um desses valores.

Comentários

Para os valores de configuração e de filtro de leitura, o snap-in possui a estrutura MMC_FILTERDATA e qualquer buffer de texto.

Se o snap-in não definir explicitamente os dados de filtro para uma coluna em uma lista filtrada chamando IHeaderCtrl2::SetColumnFilter, o tipo de filtro usará como padrão MMC_STRING_FILTER sem nenhum valor padrão para o filtro (MMC_FILTER_NOVALUE). O comprimento padrão do filtro não é documentado pelo controle de cabeçalho Win32, mas é de comprimento suficiente para as entradas de usuário mais prováveis. Se o snap-in exigir um comprimento específico, ele deverá chamar IHeaderCtrl2::SetColumnFilter.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho mmc.h
DLL Mmcndmgr.dll

Confira também

IHeaderCtrl2