estrutura MMC_FILTERDATA (mmc.h)

A estrutura MMC_FILTERDATA é introduzida no MMC 1.2.

A estrutura MMC_FILTERDATA é usada pelos métodos IHeaderCtrl2::GetColumnFilter e IHeaderCtrl2::SetColumnFilter para recuperar e definir o valor do filtro de uma coluna em uma exibição de lista filtrada.

Sintaxe

typedef struct _MMC_FILTERDATA {
  LPOLESTR pszText;
  INT      cchTextMax;
  LONG     lValue;
} MMC_FILTERDATA;

Membros

pszText

Quando um snap-in define um valor de filtro de texto, pszText aponta para a cadeia de caracteres de filtro a ser definida e cchTextMax define o comprimento máximo da cadeia de caracteres de filtro que o usuário pode digitar no campo de filtro. Quando um snap-in lê um valor de filtro de texto, pszText aponta para um buffer para receber o texto e cchTextMax fornece o comprimento do buffer.

cchTextMax

Para obter mais informações, consulte a descrição para pszText.

lValue

Quando um snap-in define um valor de filtro numérico, lValue contém o valor do filtro. O campo de filtro converte o valor em uma cadeia de caracteres e o coloca no controle de filtro. Quando um snap-in lê um valor de filtro numérico, o valor do filtro atual é convertido em binário e retornado em lValue.

Comentários

Um valor de filtro numérico pode ser usado quando a coluna que está filtrando tem apenas valores numéricos em vez de cadeias de caracteres de texto arbitrárias. A vantagem de usar um filtro numérico é que o filtro manipula a conversão entre o binário e o texto ao definir e ler o valor do filtro. Além disso, o controle de filtro só permite que um usuário digite caracteres numéricos em um filtro numérico.

Ao manipular um filtro de texto, lValue é ignorado. Da mesma forma, ao manipular um filtro numérico, pszText e cchTextMax são ignorados.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Cabeçalho	mmc.h