Метод IFolderFilterSite::SetFilter (shobjidl_core.h)

Предоставляется узлом, чтобы клиенты могли передавать узлу указатели интерфейса IUnknown .

Синтаксис

HRESULT SetFilter(
  [in] IUnknown *punk
);

Параметры

[in] punk

Тип: IUnknown*

Указатель на интерфейс IUnknown клиента. Чтобы уведомить узел о прекращении фильтрации и прекращении вызова интерфейса IFolderFilter , задайте для этого параметра значение NULL.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Получив указатель на интерфейс IFolderFilterSite узла, вызовите этот метод, чтобы передать узлу указатель на интерфейс IUnknown . Затем узел будет использовать этот указатель для вызова метода QueryInterface для запроса указателя на интерфейс IFolderFilter . Если этот вызов завершается ошибкой, функция IFolderFilterSite::SetFilter возвращает E_NOINTERFACEAVAILABLE. В случае успешного вызова узел вызовет два метода интерфейса IFolderFilter , чтобы определить способ перечисления содержимого папки.

Требования

Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)
DLL	Shell32.dll