desktop2:SearchFilterHandler

Article
01/07/2025

Enables Windows Desktop Bridge apps to register IFilters to extract file properties for searching.

Element hierarchy

<desktop2:Extension>

<desktop2:SearchFilterHandler>

Syntax

<desktop2:SearchFilterHandler
  Clsid = 'A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
  Path  = 'An optional string with a value between 1 and 256 characters in length, ending with ".dll" and cannot contain these characters: <, >, :, ", |, ?, or *.'
  ProcessorArchitecture = 'An optional string that can have one of the following values: "x86", "x64", "arm", "arm64", or "neutral".' />

  <!-- Child elements -->
  desktop2:FilterExtension{0,10000}

</desktop2:SearchFilterHandler>

Key

{} specific range of occurrences

Attributes and elements

Attributes

Attribute	Description	Data type	Required
Clsid	The ID of the class that will be activated to handle requests for files.	A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.	Yes
Path	The path to the binary in the app's package.	An optional string with a value between 1 and 256 characters in length, ending with `.dll`, that cannot contain the following characters: `<`, `>`, `:`, `"`, `\|`, `?`, or `*`.	No
ProcessorArchitecture	The processor architecture.	One of the following: x86, x64, arm, arm64, or neutral.	Yes

Child elements

Child element	Description
FilterExtension	Specifies the file type to be registered by the app.

Parent elements

Parent element	Description
Extensions	Defines one or more extensibility points for the app.

Remarks

Starting with Windows 10 Version 1809 and Windows 11 Version 22H2, this app extension will no longer work for desktop apps packaged as UWP apps using Windows Desktop Bridge. Including this extension in the package manifest for Desktop Bridge apps will have no effect.

Requirements

Item	Value
Namespace	`http://schemas.microsoft.com/appx/manifest/desktop/windows10/2`
Minimum OS Version	Windows 10 version 1703 (Build 15063)

Share via