IFileSaveDialog::SetFilter Method

  • Article

Deprecated in Windows 7. Sets the filter.

Syntax

HRESULT SetFilter(      
    IShellItemFilter *pFilter
);

Parameters

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

This method is deprecated in Windows 7.

For operating systems prior to Windows 7. This method can be used if the application needs to perform special filtering to remove some items from the dialog's view. IShellItemFilter::IncludeItem will be called for each item that would normally be included in the view. IShellItemFilter::GetEnumFlagsForItem is not used. To filter by file type, IFileDialog::SetFileTypes should be used, because in folders with a large number of items it may offer better performance than applying an IShellItemFilter.