Edit

Cloud files provider integration with Windows Search

Cloud files search allows cloud storage providers to contribute results from remote storage to File Explorer and Windows Search. This feature is supported in Windows 11, version 24H2 and later on Copilot+ PCs and AI-enabled Cloud PCs.

Registering a sync root with the Cloud Files API doesn't automatically enable cloud files search. To participate in search, a cloud storage provider must:

  1. Set the SearchHandlerFactory registry value under its sync root registry key to the class identifier (CLSID) of a COM local server.
  2. Implement IStorageProviderSearchHandlerFactory in that local server.
  3. Return an IStorageProviderSearchHandler implementation from the factory.

When Windows searches an eligible sync root, it calls the provider's Find method with the search query options. Only providers that register and implement this search handler can contribute cloud results.

For more information about the registration requirements and implementing a Cloud Sync Engine, see Build a Cloud Sync Engine that supports placeholder files.