Método IFolderFilterSite::SetFilter (shobjidl_core.h)

Exposto por um host para permitir que os clientes passem o host de seus ponteiros de interface IUnknown .

Sintaxe

HRESULT SetFilter(
  [in] IUnknown *punk
);

Parâmetros

[in] punk

Tipo: IUnknown*

Um ponteiro para a interface IUnknown do cliente. Para notificar o host para encerrar a filtragem e parar de chamar sua interface IFolderFilter , defina esse parâmetro como NULL.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Depois de obter um ponteiro para a interface IFolderFilterSite do host, chame esse método para passar ao host um ponteiro para sua interface IUnknown . Em seguida, o host usará esse ponteiro para chamar o método QueryInterface para solicitar um ponteiro para a interface IFolderFilter . Se essa chamada falhar, IFolderFilterSite::SetFilter retornará E_NOINTERFACEAVAILABLE. Se a chamada for bem-sucedida, o host chamará os dois métodos da interface IFolderFilter para determinar como enumerar o conteúdo da pasta.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)
DLL	Shell32.dll