Compartilhar via


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

O método IHeaderCtrl2::GetColumnFilter recupera o valor do filtro definido na coluna especificada.

Sintaxe

HRESULT GetColumnFilter(
  [in]      UINT           nColumn,
  [in, out] LPDWORD        pdwType,
  [in, out] 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 recuperados.

[in, out] pdwType

Um ponteiro para uma variável do tipo DWORD que pode usar um dos valores de filtro possíveis especificados na enumeração MMC_FILTER_TYPE . O tipo de filtro para a coluna especificada é colocado no endereço apontado por pdwType.

[in, out] 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.

Ao ler um valor de filtro, se o tipo de filtro especificado pelo snap-in não corresponder ao tipo atual, o método IHeaderCtrl2::GetColumnFilter retornará E_FAIL. Ao receber uma E_FAIL, os valores retornados pelo método são indefinidos.

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