Метод IHeaderCtrl2::SetColumnFilter (mmc.h)
IHeaderCtrl2::SetColumnFilter задает значение фильтра и его максимальную длину символов для указанного столбца в отфильтрованном списке.
Синтаксис
HRESULT SetColumnFilter(
[in] UINT nColumn,
[in] DWORD dwType,
[in] MMC_FILTERDATA *pFilterData
);
Параметры
[in] nColumn
Отсчитываемый от нуля индекс, определяющий столбец, для которого необходимо задать значение фильтра и его максимальную длину символов.
[in] dwType
Тип фильтра для применения к указанному столбцу, взятого из перечисления MMC_FILTER_TYPE .
[in] pFilterData
Указатель на структуру MMC_FILTERDATA , содержащую фактические данные фильтра.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
Комментарии
Для установки и чтения значений фильтра оснастка владеет структурой MMC_FILTERDATA и любым текстовым буфером.
Если оснастка не задает явным образом данные фильтра для столбца в отфильтрованном списке путем вызова метода IHeaderCtrl2::SetColumnFilter, тип фильтра по умолчанию MMC_STRING_FILTER без значения по умолчанию для фильтра (MMC_FILTER_NOVALUE). Длина фильтра по умолчанию не задокументирована элементом управления заголовком Win32, но она достаточна для наиболее вероятного ввода данных пользователем. Если оснастка требует определенной длины, она должна вызвать IHeaderCtrl2::SetColumnFilter.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | mmc.h |
| DLL | Mmcndmgr.dll |