Registering a sync root via Win32 API is missing documentation (cfapi)

oknick 101 Reputation points
2022-05-14T18:50:13.71+00:00

Looking at the UWP API for registering a sync root via StorageProviderSyncRootInfo, it seems to have many more fields that the Win32 API does not. To be specific, the AllowPinning, FallbackFileTypeInfo, IconResource, ProtectionMode, RecycleBinUri, ShowSiblingsAsGroup, and StorageProviderItemPropertyDefinitions fields.

The UWP API automatically takes care of registration with the shell, which is why it has so much more, but in the documentation to manually register a sync root with the shell, found here, it does not mention these properties.

I can find most of them by looking through the registry, although they should be officially documented.

Windows API - Win32
Windows API - Win32
A core set of Windows application programming interfaces (APIs) for desktop and server applications. Previously known as Win32 API.
2,429 questions
0 comments No comments
{count} votes

1 answer

Sort by: Most helpful
  1. Junjie Zhu - MSFT 15,211 Reputation points Microsoft Vendor
    2022-05-16T07:13:27.197+00:00

    Hello,
    Welcome to Microsoft Q&A!

    According to the official documentation Build a Cloud Sync Engine that Supports Placeholder Files,

    The cloud files API contains the following native Win32 APIs and Windows Runtime (WinRT) API
    Windows.Storage.Provider namespace: This WinRT API enables applications to configure the cloud storage provider and register the sync root with the operating system.

    At present, there is no Win32 API document related to sync root properties, it needs to be used in conjunction with the WinRT API.

    Thank you.


    If the answer is the right solution, please click "Accept Answer" and kindly upvote it. If you have extra questions about this answer, please click "Comment".
    Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.

    1 person found this answer helpful.