known_folders\win/
known_folder.rs

1// src/win/known_folder.rs
2//
3// Copyright (c) 2023 Ryan Lopopolo <rjl@hyperbo.la>
4//
5// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE> or
6// <http://www.apache.org/licenses/LICENSE-2.0> or the MIT license <LICENSE-MIT>
7// or <http://opensource.org/licenses/MIT>, at your option. All files in the
8// project carrying such notice may not be copied, modified, or distributed
9// except according to those terms.
10
11use windows_sys::core::GUID;
12use windows_sys::Win32::UI::Shell::{
13    FOLDERID_AccountPictures, FOLDERID_AddNewPrograms, FOLDERID_AdminTools, FOLDERID_AllAppMods,
14    FOLDERID_AppCaptures, FOLDERID_AppDataDesktop, FOLDERID_AppDataDocuments,
15    FOLDERID_AppDataFavorites, FOLDERID_AppDataProgramData, FOLDERID_AppUpdates,
16    FOLDERID_ApplicationShortcuts, FOLDERID_AppsFolder, FOLDERID_CDBurning, FOLDERID_CameraRoll,
17    FOLDERID_CameraRollLibrary, FOLDERID_ChangeRemovePrograms, FOLDERID_CommonAdminTools,
18    FOLDERID_CommonOEMLinks, FOLDERID_CommonPrograms, FOLDERID_CommonStartMenu,
19    FOLDERID_CommonStartMenuPlaces, FOLDERID_CommonStartup, FOLDERID_CommonTemplates,
20    FOLDERID_ComputerFolder, FOLDERID_ConflictFolder, FOLDERID_ConnectionsFolder,
21    FOLDERID_Contacts, FOLDERID_ControlPanelFolder, FOLDERID_Cookies, FOLDERID_CurrentAppMods,
22    FOLDERID_Desktop, FOLDERID_DevelopmentFiles, FOLDERID_Device, FOLDERID_DeviceMetadataStore,
23    FOLDERID_Documents, FOLDERID_DocumentsLibrary, FOLDERID_Downloads, FOLDERID_Favorites,
24    FOLDERID_Fonts, FOLDERID_GameTasks, FOLDERID_Games, FOLDERID_History, FOLDERID_HomeGroup,
25    FOLDERID_HomeGroupCurrentUser, FOLDERID_ImplicitAppShortcuts, FOLDERID_InternetCache,
26    FOLDERID_InternetFolder, FOLDERID_Libraries, FOLDERID_Links, FOLDERID_LocalAppData,
27    FOLDERID_LocalAppDataLow, FOLDERID_LocalDocuments, FOLDERID_LocalDownloads,
28    FOLDERID_LocalMusic, FOLDERID_LocalPictures, FOLDERID_LocalStorage, FOLDERID_LocalVideos,
29    FOLDERID_LocalizedResourcesDir, FOLDERID_Music, FOLDERID_MusicLibrary, FOLDERID_NetHood,
30    FOLDERID_NetworkFolder, FOLDERID_Objects3D, FOLDERID_OneDrive, FOLDERID_OriginalImages,
31    FOLDERID_PhotoAlbums, FOLDERID_Pictures, FOLDERID_PicturesLibrary, FOLDERID_Playlists,
32    FOLDERID_PrintHood, FOLDERID_PrintersFolder, FOLDERID_Profile, FOLDERID_ProgramData,
33    FOLDERID_ProgramFiles, FOLDERID_ProgramFilesCommon, FOLDERID_ProgramFilesCommonX64,
34    FOLDERID_ProgramFilesCommonX86, FOLDERID_ProgramFilesX64, FOLDERID_ProgramFilesX86,
35    FOLDERID_Programs, FOLDERID_Public, FOLDERID_PublicDesktop, FOLDERID_PublicDocuments,
36    FOLDERID_PublicDownloads, FOLDERID_PublicGameTasks, FOLDERID_PublicLibraries,
37    FOLDERID_PublicMusic, FOLDERID_PublicPictures, FOLDERID_PublicRingtones,
38    FOLDERID_PublicUserTiles, FOLDERID_PublicVideos, FOLDERID_QuickLaunch, FOLDERID_Recent,
39    FOLDERID_RecordedCalls, FOLDERID_RecordedTVLibrary, FOLDERID_RecycleBinFolder,
40    FOLDERID_ResourceDir, FOLDERID_RetailDemo, FOLDERID_Ringtones, FOLDERID_RoamedTileImages,
41    FOLDERID_RoamingAppData, FOLDERID_RoamingTiles, FOLDERID_SampleMusic, FOLDERID_SamplePictures,
42    FOLDERID_SamplePlaylists, FOLDERID_SampleVideos, FOLDERID_SavedGames, FOLDERID_SavedPictures,
43    FOLDERID_SavedPicturesLibrary, FOLDERID_SavedSearches, FOLDERID_Screenshots,
44    FOLDERID_SearchHistory, FOLDERID_SearchHome, FOLDERID_SearchTemplates, FOLDERID_SendTo,
45    FOLDERID_SidebarDefaultParts, FOLDERID_SidebarParts, FOLDERID_SkyDrive,
46    FOLDERID_SkyDriveCameraRoll, FOLDERID_SkyDriveDocuments, FOLDERID_SkyDriveMusic,
47    FOLDERID_SkyDrivePictures, FOLDERID_StartMenu, FOLDERID_StartMenuAllPrograms, FOLDERID_Startup,
48    FOLDERID_SyncManagerFolder, FOLDERID_SyncResultsFolder, FOLDERID_SyncSetupFolder,
49    FOLDERID_System, FOLDERID_SystemX86, FOLDERID_Templates, FOLDERID_UserPinned,
50    FOLDERID_UserProfiles, FOLDERID_UserProgramFiles, FOLDERID_UserProgramFilesCommon,
51    FOLDERID_UsersFiles, FOLDERID_UsersLibraries, FOLDERID_Videos, FOLDERID_VideosLibrary,
52    FOLDERID_Windows, FOLDERID_SEARCH_CSC, FOLDERID_SEARCH_MAPI,
53};
54
55/// GUIDs that identify standard folders registered with the system as
56/// [Known Folders].
57///
58/// These folders are installed with Windows Vista and later operating systems,
59/// and a computer will have only folders appropriate to it installed.
60///
61/// For details on the **KNOWNFOLDERID** constants this enum represents, please
62/// refer to the [upstream documentation].
63///
64/// # Compatibility Notes
65///
66/// The Known Folders API allows for ISVs to extend the set of Known Folder IDs,
67/// but this enum only has support for first-party Known Folder IDs included in
68/// [`windows_sys`].
69///
70/// # Examples
71///
72/// ```
73/// use known_folders::{get_known_folder_path, KnownFolder};
74///
75/// let profile_dir = get_known_folder_path(KnownFolder::Profile);
76/// ```
77///
78/// [Known Folders]: https://learn.microsoft.com/en-us/windows/win32/shell/known-folders
79/// [upstream documentation]: https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#constants
80#[non_exhaustive]
81#[allow(non_camel_case_types)]
82#[derive(Debug, Clone, Copy, Hash, PartialEq, Eq)]
83pub enum KnownFolder {
84    /// Known Folder ID `FOLDERID_AccountPictures`.
85    ///
86    /// # Upstream Documentation
87    ///
88    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_AccountPictures`]
89    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_AccountPictures>
90    AccountPictures,
91    /// Known Folder ID `FOLDERID_AddNewPrograms`.
92    ///
93    /// # Upstream Documentation
94    ///
95    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_AddNewPrograms`]
96    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_AddNewPrograms>
97    AddNewPrograms,
98    /// Known Folder ID `FOLDERID_AdminTools`.
99    ///
100    /// # Upstream Documentation
101    ///
102    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_AdminTools`]
103    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_AdminTools>
104    AdminTools,
105    /// Known Folder ID `FOLDERID_AllAppMods`.
106    ///
107    /// # Upstream Documentation
108    ///
109    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_AllAppMods`]
110    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_AllAppMods>
111    AllAppMods,
112    /// Known Folder ID `FOLDERID_AppCaptures`.
113    ///
114    /// # Upstream Documentation
115    ///
116    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_AppCaptures`]
117    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_AppCaptures>
118    AppCaptures,
119    /// Known Folder ID `FOLDERID_AppDataDesktop`.
120    ///
121    /// # Upstream Documentation
122    ///
123    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_AppDataDesktop`]
124    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_AppDataDesktop>
125    AppDataDesktop,
126    /// Known Folder ID `FOLDERID_AppDataDocuments`.
127    ///
128    /// # Upstream Documentation
129    ///
130    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_AppDataDocuments`]
131    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_AppDataDocuments>
132    AppDataDocuments,
133    /// Known Folder ID `FOLDERID_AppDataFavorites`.
134    ///
135    /// # Upstream Documentation
136    ///
137    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_AppDataFavorites`]
138    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_AppDataFavorites>
139    AppDataFavorites,
140    /// Known Folder ID `FOLDERID_AppDataProgramData`.
141    ///
142    /// # Upstream Documentation
143    ///
144    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_AppDataProgramData`]
145    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_AppDataProgramData>
146    AppDataProgramData,
147    /// Known Folder ID `FOLDERID_AppUpdates`.
148    ///
149    /// # Upstream Documentation
150    ///
151    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_AppUpdates`]
152    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_AppUpdates>
153    AppUpdates,
154    /// Known Folder ID `FOLDERID_ApplicationShortcuts`.
155    ///
156    /// # Upstream Documentation
157    ///
158    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_ApplicationShortcuts`]
159    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_ApplicationShortcuts>
160    ApplicationShortcuts,
161    /// Known Folder ID `FOLDERID_AppsFolder`.
162    ///
163    /// # Upstream Documentation
164    ///
165    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_AppsFolder`]
166    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_AppsFolder>
167    AppsFolder,
168    /// Known Folder ID `FOLDERID_CDBurning`.
169    ///
170    /// # Upstream Documentation
171    ///
172    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_CDBurning`]
173    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_CDBurning>
174    CDBurning,
175    /// Known Folder ID `FOLDERID_CameraRoll`.
176    ///
177    /// # Upstream Documentation
178    ///
179    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_CameraRoll`]
180    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_CameraRoll>
181    CameraRoll,
182    /// Known Folder ID `FOLDERID_CameraRollLibrary`.
183    ///
184    /// # Upstream Documentation
185    ///
186    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_CameraRollLibrary`]
187    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_CameraRollLibrary>
188    CameraRollLibrary,
189    /// Known Folder ID `FOLDERID_ChangeRemovePrograms`.
190    ///
191    /// # Upstream Documentation
192    ///
193    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_ChangeRemovePrograms`]
194    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_ChangeRemovePrograms>
195    ChangeRemovePrograms,
196    /// Known Folder ID `FOLDERID_CommonAdminTools`.
197    ///
198    /// # Upstream Documentation
199    ///
200    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_CommonAdminTools`]
201    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_CommonAdminTools>
202    CommonAdminTools,
203    /// Known Folder ID `FOLDERID_CommonOEMLinks`.
204    ///
205    /// # Upstream Documentation
206    ///
207    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_CommonOEMLinks`]
208    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_CommonOEMLinks>
209    CommonOEMLinks,
210    /// Known Folder ID `FOLDERID_CommonPrograms`.
211    ///
212    /// # Upstream Documentation
213    ///
214    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_CommonPrograms`]
215    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_CommonPrograms>
216    CommonPrograms,
217    /// Known Folder ID `FOLDERID_CommonStartMenu`.
218    ///
219    /// # Upstream Documentation
220    ///
221    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_CommonStartMenu`]
222    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_CommonStartMenu>
223    CommonStartMenu,
224    /// Known Folder ID `FOLDERID_CommonStartMenuPlaces`.
225    ///
226    /// # Upstream Documentation
227    ///
228    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_CommonStartMenuPlaces`]
229    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_CommonStartMenuPlaces>
230    CommonStartMenuPlaces,
231    /// Known Folder ID `FOLDERID_CommonStartup`.
232    ///
233    /// # Upstream Documentation
234    ///
235    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_CommonStartup`]
236    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_CommonStartup>
237    CommonStartup,
238    /// Known Folder ID `FOLDERID_CommonTemplates`.
239    ///
240    /// # Upstream Documentation
241    ///
242    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_CommonTemplates`]
243    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_CommonTemplates>
244    CommonTemplates,
245    /// Known Folder ID `FOLDERID_ComputerFolder`.
246    ///
247    /// # Upstream Documentation
248    ///
249    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_ComputerFolder`]
250    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_ComputerFolder>
251    ComputerFolder,
252    /// Known Folder ID `FOLDERID_ConflictFolder`.
253    ///
254    /// # Upstream Documentation
255    ///
256    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_ConflictFolder`]
257    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_ConflictFolder>
258    ConflictFolder,
259    /// Known Folder ID `FOLDERID_ConnectionsFolder`.
260    ///
261    /// # Upstream Documentation
262    ///
263    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_ConnectionsFolder`]
264    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_ConnectionsFolder>
265    ConnectionsFolder,
266    /// Known Folder ID `FOLDERID_Contacts`.
267    ///
268    /// # Upstream Documentation
269    ///
270    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Contacts`]
271    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Contacts>
272    Contacts,
273    /// Known Folder ID `FOLDERID_ControlPanelFolder`.
274    ///
275    /// # Upstream Documentation
276    ///
277    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_ControlPanelFolder`]
278    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_ControlPanelFolder>
279    ControlPanelFolder,
280    /// Known Folder ID `FOLDERID_Cookies`.
281    ///
282    /// # Upstream Documentation
283    ///
284    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Cookies`]
285    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Cookies>
286    Cookies,
287    /// Known Folder ID `FOLDERID_CurrentAppMods`.
288    ///
289    /// # Upstream Documentation
290    ///
291    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_CurrentAppMods`]
292    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_CurrentAppMods>
293    CurrentAppMods,
294    /// Known Folder ID `FOLDERID_Desktop`.
295    ///
296    /// # Upstream Documentation
297    ///
298    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Desktop`]
299    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Desktop>
300    Desktop,
301    /// Known Folder ID `FOLDERID_DevelopmentFiles`.
302    ///
303    /// # Upstream Documentation
304    ///
305    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_DevelopmentFiles`]
306    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_DevelopmentFiles>
307    DevelopmentFiles,
308    /// Known Folder ID `FOLDERID_Device`.
309    ///
310    /// # Upstream Documentation
311    ///
312    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Device`]
313    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Device>
314    Device,
315    /// Known Folder ID `FOLDERID_DeviceMetadataStore`.
316    ///
317    /// # Upstream Documentation
318    ///
319    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_DeviceMetadataStore`]
320    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_DeviceMetadataStore>
321    DeviceMetadataStore,
322    /// Known Folder ID `FOLDERID_Documents`.
323    ///
324    /// # Upstream Documentation
325    ///
326    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Documents`]
327    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Documents>
328    Documents,
329    /// Known Folder ID `FOLDERID_DocumentsLibrary`.
330    ///
331    /// # Upstream Documentation
332    ///
333    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_DocumentsLibrary`]
334    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_DocumentsLibrary>
335    DocumentsLibrary,
336    /// Known Folder ID `FOLDERID_Downloads`.
337    ///
338    /// # Upstream Documentation
339    ///
340    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Downloads`]
341    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Downloads>
342    Downloads,
343    /// Known Folder ID `FOLDERID_Favorites`.
344    ///
345    /// # Upstream Documentation
346    ///
347    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Favorites`]
348    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Favorites>
349    Favorites,
350    /// Known Folder ID `FOLDERID_Fonts`.
351    ///
352    /// # Upstream Documentation
353    ///
354    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Fonts`]
355    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Fonts>
356    Fonts,
357    /// Known Folder ID `FOLDERID_GameTasks`.
358    ///
359    /// # Upstream Documentation
360    ///
361    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_GameTasks`]
362    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_GameTasks>
363    GameTasks,
364    /// Known Folder ID `FOLDERID_Games`.
365    ///
366    /// # Upstream Documentation
367    ///
368    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Games`]
369    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Games>
370    Games,
371    /// Known Folder ID `FOLDERID_History`.
372    ///
373    /// # Upstream Documentation
374    ///
375    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_History`]
376    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_History>
377    History,
378    /// Known Folder ID `FOLDERID_HomeGroup`.
379    ///
380    /// # Upstream Documentation
381    ///
382    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_HomeGroup`]
383    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_HomeGroup>
384    HomeGroup,
385    /// Known Folder ID `FOLDERID_HomeGroupCurrentUser`.
386    ///
387    /// # Upstream Documentation
388    ///
389    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_HomeGroupCurrentUser`]
390    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_HomeGroupCurrentUser>
391    HomeGroupCurrentUser,
392    /// Known Folder ID `FOLDERID_ImplicitAppShortcuts`.
393    ///
394    /// # Upstream Documentation
395    ///
396    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_ImplicitAppShortcuts`]
397    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_ImplicitAppShortcuts>
398    ImplicitAppShortcuts,
399    /// Known Folder ID `FOLDERID_InternetCache`.
400    ///
401    /// # Upstream Documentation
402    ///
403    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_InternetCache`]
404    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_InternetCache>
405    InternetCache,
406    /// Known Folder ID `FOLDERID_InternetFolder`.
407    ///
408    /// # Upstream Documentation
409    ///
410    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_InternetFolder`]
411    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_InternetFolder>
412    InternetFolder,
413    /// Known Folder ID `FOLDERID_Libraries`.
414    ///
415    /// # Upstream Documentation
416    ///
417    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Libraries`]
418    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Libraries>
419    Libraries,
420    /// Known Folder ID `FOLDERID_Links`.
421    ///
422    /// # Upstream Documentation
423    ///
424    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Links`]
425    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Links>
426    Links,
427    /// Known Folder ID `FOLDERID_LocalAppData`.
428    ///
429    /// # Upstream Documentation
430    ///
431    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_LocalAppData`]
432    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_LocalAppData>
433    LocalAppData,
434    /// Known Folder ID `FOLDERID_LocalAppDataLow`.
435    ///
436    /// # Upstream Documentation
437    ///
438    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_LocalAppDataLow`]
439    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_LocalAppDataLow>
440    LocalAppDataLow,
441    /// Known Folder ID `FOLDERID_LocalDocuments`.
442    ///
443    /// # Upstream Documentation
444    ///
445    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_LocalDocuments`]
446    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_LocalDocuments>
447    LocalDocuments,
448    /// Known Folder ID `FOLDERID_LocalDownloads`.
449    ///
450    /// # Upstream Documentation
451    ///
452    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_LocalDownloads`]
453    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_LocalDownloads>
454    LocalDownloads,
455    /// Known Folder ID `FOLDERID_LocalMusic`.
456    ///
457    /// # Upstream Documentation
458    ///
459    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_LocalMusic`]
460    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_LocalMusic>
461    LocalMusic,
462    /// Known Folder ID `FOLDERID_LocalPictures`.
463    ///
464    /// # Upstream Documentation
465    ///
466    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_LocalPictures`]
467    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_LocalPictures>
468    LocalPictures,
469    /// Known Folder ID `FOLDERID_LocalStorage`.
470    ///
471    /// # Upstream Documentation
472    ///
473    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_LocalStorage`]
474    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_LocalStorage>
475    LocalStorage,
476    /// Known Folder ID `FOLDERID_LocalVideos`.
477    ///
478    /// # Upstream Documentation
479    ///
480    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_LocalVideos`]
481    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_LocalVideos>
482    LocalVideos,
483    /// Known Folder ID `FOLDERID_LocalizedResourcesDir`.
484    ///
485    /// # Upstream Documentation
486    ///
487    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_LocalizedResourcesDir`]
488    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_LocalizedResourcesDir>
489    LocalizedResourcesDir,
490    /// Known Folder ID `FOLDERID_Music`.
491    ///
492    /// # Upstream Documentation
493    ///
494    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Music`]
495    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Music>
496    Music,
497    /// Known Folder ID `FOLDERID_MusicLibrary`.
498    ///
499    /// # Upstream Documentation
500    ///
501    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_MusicLibrary`]
502    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_MusicLibrary>
503    MusicLibrary,
504    /// Known Folder ID `FOLDERID_NetHood`.
505    ///
506    /// # Upstream Documentation
507    ///
508    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_NetHood`]
509    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_NetHood>
510    NetHood,
511    /// Known Folder ID `FOLDERID_NetworkFolder`.
512    ///
513    /// # Upstream Documentation
514    ///
515    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_NetworkFolder`]
516    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_NetworkFolder>
517    NetworkFolder,
518    /// Known Folder ID `FOLDERID_Objects3D`.
519    ///
520    /// # Upstream Documentation
521    ///
522    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Objects3D`]
523    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Objects3D>
524    Objects3D,
525    /// Known Folder ID `FOLDERID_OneDrive`.
526    ///
527    /// # Upstream Documentation
528    ///
529    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_OneDrive`]
530    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_OneDrive>
531    OneDrive,
532    /// Known Folder ID `FOLDERID_OriginalImages`.
533    ///
534    /// # Upstream Documentation
535    ///
536    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_OriginalImages`]
537    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_OriginalImages>
538    OriginalImages,
539    /// Known Folder ID `FOLDERID_PhotoAlbums`.
540    ///
541    /// # Upstream Documentation
542    ///
543    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_PhotoAlbums`]
544    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_PhotoAlbums>
545    PhotoAlbums,
546    /// Known Folder ID `FOLDERID_Pictures`.
547    ///
548    /// # Upstream Documentation
549    ///
550    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Pictures`]
551    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Pictures>
552    Pictures,
553    /// Known Folder ID `FOLDERID_PicturesLibrary`.
554    ///
555    /// # Upstream Documentation
556    ///
557    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_PicturesLibrary`]
558    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_PicturesLibrary>
559    PicturesLibrary,
560    /// Known Folder ID `FOLDERID_Playlists`.
561    ///
562    /// # Upstream Documentation
563    ///
564    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Playlists`]
565    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Playlists>
566    Playlists,
567    /// Known Folder ID `FOLDERID_PrintHood`.
568    ///
569    /// # Upstream Documentation
570    ///
571    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_PrintHood`]
572    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_PrintHood>
573    PrintHood,
574    /// Known Folder ID `FOLDERID_PrintersFolder`.
575    ///
576    /// # Upstream Documentation
577    ///
578    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_PrintersFolder`]
579    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_PrintersFolder>
580    PrintersFolder,
581    /// Known Folder ID `FOLDERID_Profile`.
582    ///
583    /// # Upstream Documentation
584    ///
585    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Profile`]
586    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Profile>
587    Profile,
588    /// Known Folder ID `FOLDERID_ProgramData`.
589    ///
590    /// # Upstream Documentation
591    ///
592    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_ProgramData`]
593    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_ProgramData>
594    ProgramData,
595    /// Known Folder ID `FOLDERID_ProgramFiles`.
596    ///
597    /// # Upstream Documentation
598    ///
599    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_ProgramFiles`]
600    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_ProgramFiles>
601    ProgramFiles,
602    /// Known Folder ID `FOLDERID_ProgramFilesCommon`.
603    ///
604    /// # Upstream Documentation
605    ///
606    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_ProgramFilesCommon`]
607    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_ProgramFilesCommon>
608    ProgramFilesCommon,
609    /// Known Folder ID `FOLDERID_ProgramFilesCommonX64`.
610    ///
611    /// # Upstream Documentation
612    ///
613    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_ProgramFilesCommonX64`]
614    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_ProgramFilesCommonX64>
615    ProgramFilesCommonX64,
616    /// Known Folder ID `FOLDERID_ProgramFilesCommonX86`.
617    ///
618    /// # Upstream Documentation
619    ///
620    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_ProgramFilesCommonX86`]
621    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_ProgramFilesCommonX86>
622    ProgramFilesCommonX86,
623    /// Known Folder ID `FOLDERID_ProgramFilesX64`.
624    ///
625    /// # Upstream Documentation
626    ///
627    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_ProgramFilesX64`]
628    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_ProgramFilesX64>
629    ProgramFilesX64,
630    /// Known Folder ID `FOLDERID_ProgramFilesX86`.
631    ///
632    /// # Upstream Documentation
633    ///
634    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_ProgramFilesX86`]
635    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_ProgramFilesX86>
636    ProgramFilesX86,
637    /// Known Folder ID `FOLDERID_Programs`.
638    ///
639    /// # Upstream Documentation
640    ///
641    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Programs`]
642    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Programs>
643    Programs,
644    /// Known Folder ID `FOLDERID_Public`.
645    ///
646    /// # Upstream Documentation
647    ///
648    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Public`]
649    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Public>
650    Public,
651    /// Known Folder ID `FOLDERID_PublicDesktop`.
652    ///
653    /// # Upstream Documentation
654    ///
655    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_PublicDesktop`]
656    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_PublicDesktop>
657    PublicDesktop,
658    /// Known Folder ID `FOLDERID_PublicDocuments`.
659    ///
660    /// # Upstream Documentation
661    ///
662    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_PublicDocuments`]
663    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_PublicDocuments>
664    PublicDocuments,
665    /// Known Folder ID `FOLDERID_PublicDownloads`.
666    ///
667    /// # Upstream Documentation
668    ///
669    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_PublicDownloads`]
670    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_PublicDownloads>
671    PublicDownloads,
672    /// Known Folder ID `FOLDERID_PublicGameTasks`.
673    ///
674    /// # Upstream Documentation
675    ///
676    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_PublicGameTasks`]
677    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_PublicGameTasks>
678    PublicGameTasks,
679    /// Known Folder ID `FOLDERID_PublicLibraries`.
680    ///
681    /// # Upstream Documentation
682    ///
683    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_PublicLibraries`]
684    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_PublicLibraries>
685    PublicLibraries,
686    /// Known Folder ID `FOLDERID_PublicMusic`.
687    ///
688    /// # Upstream Documentation
689    ///
690    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_PublicMusic`]
691    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_PublicMusic>
692    PublicMusic,
693    /// Known Folder ID `FOLDERID_PublicPictures`.
694    ///
695    /// # Upstream Documentation
696    ///
697    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_PublicPictures`]
698    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_PublicPictures>
699    PublicPictures,
700    /// Known Folder ID `FOLDERID_PublicRingtones`.
701    ///
702    /// # Upstream Documentation
703    ///
704    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_PublicRingtones`]
705    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_PublicRingtones>
706    PublicRingtones,
707    /// Known Folder ID `FOLDERID_PublicUserTiles`.
708    ///
709    /// # Upstream Documentation
710    ///
711    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_PublicUserTiles`]
712    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_PublicUserTiles>
713    PublicUserTiles,
714    /// Known Folder ID `FOLDERID_PublicVideos`.
715    ///
716    /// # Upstream Documentation
717    ///
718    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_PublicVideos`]
719    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_PublicVideos>
720    PublicVideos,
721    /// Known Folder ID `FOLDERID_QuickLaunch`.
722    ///
723    /// # Upstream Documentation
724    ///
725    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_QuickLaunch`]
726    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_QuickLaunch>
727    QuickLaunch,
728    /// Known Folder ID `FOLDERID_Recent`.
729    ///
730    /// # Upstream Documentation
731    ///
732    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Recent`]
733    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Recent>
734    Recent,
735    /// Known Folder ID `FOLDERID_RecordedCalls`.
736    ///
737    /// # Upstream Documentation
738    ///
739    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_RecordedCalls`]
740    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_RecordedCalls>
741    RecordedCalls,
742    /// Known Folder ID `FOLDERID_RecordedTVLibrary`.
743    ///
744    /// # Upstream Documentation
745    ///
746    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_RecordedTVLibrary`]
747    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_RecordedTVLibrary>
748    RecordedTVLibrary,
749    /// Known Folder ID `FOLDERID_RecycleBinFolder`.
750    ///
751    /// # Upstream Documentation
752    ///
753    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_RecycleBinFolder`]
754    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_RecycleBinFolder>
755    RecycleBinFolder,
756    /// Known Folder ID `FOLDERID_ResourceDir`.
757    ///
758    /// # Upstream Documentation
759    ///
760    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_ResourceDir`]
761    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_ResourceDir>
762    ResourceDir,
763    /// Known Folder ID `FOLDERID_RetailDemo`.
764    ///
765    /// # Upstream Documentation
766    ///
767    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_RetailDemo`]
768    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_RetailDemo>
769    RetailDemo,
770    /// Known Folder ID `FOLDERID_Ringtones`.
771    ///
772    /// # Upstream Documentation
773    ///
774    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Ringtones`]
775    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Ringtones>
776    Ringtones,
777    /// Known Folder ID `FOLDERID_RoamedTileImages`.
778    ///
779    /// # Upstream Documentation
780    ///
781    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_RoamedTileImages`]
782    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_RoamedTileImages>
783    RoamedTileImages,
784    /// Known Folder ID `FOLDERID_RoamingAppData`.
785    ///
786    /// # Upstream Documentation
787    ///
788    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_RoamingAppData`]
789    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_RoamingAppData>
790    RoamingAppData,
791    /// Known Folder ID `FOLDERID_RoamingTiles`.
792    ///
793    /// # Upstream Documentation
794    ///
795    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_RoamingTiles`]
796    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_RoamingTiles>
797    RoamingTiles,
798    /// Known Folder ID `FOLDERID_SEARCH_CSC`.
799    ///
800    /// # Upstream Documentation
801    ///
802    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SEARCH_CSC`]
803    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SEARCH_CSC>
804    SEARCH_CSC,
805    /// Known Folder ID `FOLDERID_SEARCH_MAPI`.
806    ///
807    /// # Upstream Documentation
808    ///
809    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SEARCH_MAPI`]
810    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SEARCH_MAPI>
811    SEARCH_MAPI,
812    /// Known Folder ID `FOLDERID_SampleMusic`.
813    ///
814    /// # Upstream Documentation
815    ///
816    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SampleMusic`]
817    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SampleMusic>
818    SampleMusic,
819    /// Known Folder ID `FOLDERID_SamplePictures`.
820    ///
821    /// # Upstream Documentation
822    ///
823    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SamplePictures`]
824    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SamplePictures>
825    SamplePictures,
826    /// Known Folder ID `FOLDERID_SamplePlaylists`.
827    ///
828    /// # Upstream Documentation
829    ///
830    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SamplePlaylists`]
831    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SamplePlaylists>
832    SamplePlaylists,
833    /// Known Folder ID `FOLDERID_SampleVideos`.
834    ///
835    /// # Upstream Documentation
836    ///
837    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SampleVideos`]
838    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SampleVideos>
839    SampleVideos,
840    /// Known Folder ID `FOLDERID_SavedGames`.
841    ///
842    /// # Upstream Documentation
843    ///
844    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SavedGames`]
845    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SavedGames>
846    SavedGames,
847    /// Known Folder ID `FOLDERID_SavedPictures`.
848    ///
849    /// # Upstream Documentation
850    ///
851    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SavedPictures`]
852    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SavedPictures>
853    SavedPictures,
854    /// Known Folder ID `FOLDERID_SavedPicturesLibrary`.
855    ///
856    /// # Upstream Documentation
857    ///
858    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SavedPicturesLibrary`]
859    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SavedPicturesLibrary>
860    SavedPicturesLibrary,
861    /// Known Folder ID `FOLDERID_SavedSearches`.
862    ///
863    /// # Upstream Documentation
864    ///
865    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SavedSearches`]
866    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SavedSearches>
867    SavedSearches,
868    /// Known Folder ID `FOLDERID_Screenshots`.
869    ///
870    /// # Upstream Documentation
871    ///
872    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Screenshots`]
873    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Screenshots>
874    Screenshots,
875    /// Known Folder ID `FOLDERID_SearchHistory`.
876    ///
877    /// # Upstream Documentation
878    ///
879    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SearchHistory`]
880    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SearchHistory>
881    SearchHistory,
882    /// Known Folder ID `FOLDERID_SearchHome`.
883    ///
884    /// # Upstream Documentation
885    ///
886    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SearchHome`]
887    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SearchHome>
888    SearchHome,
889    /// Known Folder ID `FOLDERID_SearchTemplates`.
890    ///
891    /// # Upstream Documentation
892    ///
893    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SearchTemplates`]
894    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SearchTemplates>
895    SearchTemplates,
896    /// Known Folder ID `FOLDERID_SendTo`.
897    ///
898    /// # Upstream Documentation
899    ///
900    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SendTo`]
901    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SendTo>
902    SendTo,
903    /// Known Folder ID `FOLDERID_SidebarDefaultParts`.
904    ///
905    /// # Upstream Documentation
906    ///
907    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SidebarDefaultParts`]
908    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SidebarDefaultParts>
909    SidebarDefaultParts,
910    /// Known Folder ID `FOLDERID_SidebarParts`.
911    ///
912    /// # Upstream Documentation
913    ///
914    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SidebarParts`]
915    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SidebarParts>
916    SidebarParts,
917    /// Known Folder ID `FOLDERID_SkyDrive`.
918    ///
919    /// # Upstream Documentation
920    ///
921    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SkyDrive`]
922    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SkyDrive>
923    SkyDrive,
924    /// Known Folder ID `FOLDERID_SkyDriveCameraRoll`.
925    ///
926    /// # Upstream Documentation
927    ///
928    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SkyDriveCameraRoll`]
929    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SkyDriveCameraRoll>
930    SkyDriveCameraRoll,
931    /// Known Folder ID `FOLDERID_SkyDriveDocuments`.
932    ///
933    /// # Upstream Documentation
934    ///
935    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SkyDriveDocuments`]
936    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SkyDriveDocuments>
937    SkyDriveDocuments,
938    /// Known Folder ID `FOLDERID_SkyDriveMusic`.
939    ///
940    /// # Upstream Documentation
941    ///
942    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SkyDriveMusic`]
943    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SkyDriveMusic>
944    SkyDriveMusic,
945    /// Known Folder ID `FOLDERID_SkyDrivePictures`.
946    ///
947    /// # Upstream Documentation
948    ///
949    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SkyDrivePictures`]
950    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SkyDrivePictures>
951    SkyDrivePictures,
952    /// Known Folder ID `FOLDERID_StartMenu`.
953    ///
954    /// # Upstream Documentation
955    ///
956    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_StartMenu`]
957    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_StartMenu>
958    StartMenu,
959    /// Known Folder ID `FOLDERID_StartMenuAllPrograms`.
960    ///
961    /// # Upstream Documentation
962    ///
963    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_StartMenuAllPrograms`]
964    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_StartMenuAllPrograms>
965    StartMenuAllPrograms,
966    /// Known Folder ID `FOLDERID_Startup`.
967    ///
968    /// # Upstream Documentation
969    ///
970    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Startup`]
971    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Startup>
972    Startup,
973    /// Known Folder ID `FOLDERID_SyncManagerFolder`.
974    ///
975    /// # Upstream Documentation
976    ///
977    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SyncManagerFolder`]
978    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SyncManagerFolder>
979    SyncManagerFolder,
980    /// Known Folder ID `FOLDERID_SyncResultsFolder`.
981    ///
982    /// # Upstream Documentation
983    ///
984    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SyncResultsFolder`]
985    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SyncResultsFolder>
986    SyncResultsFolder,
987    /// Known Folder ID `FOLDERID_SyncSetupFolder`.
988    ///
989    /// # Upstream Documentation
990    ///
991    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SyncSetupFolder`]
992    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SyncSetupFolder>
993    SyncSetupFolder,
994    /// Known Folder ID `FOLDERID_System`.
995    ///
996    /// # Upstream Documentation
997    ///
998    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_System`]
999    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_System>
1000    System,
1001    /// Known Folder ID `FOLDERID_SystemX86`.
1002    ///
1003    /// # Upstream Documentation
1004    ///
1005    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_SystemX86`]
1006    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_SystemX86>
1007    SystemX86,
1008    /// Known Folder ID `FOLDERID_Templates`.
1009    ///
1010    /// # Upstream Documentation
1011    ///
1012    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Templates`]
1013    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Templates>
1014    Templates,
1015    /// Known Folder ID `FOLDERID_UserPinned`.
1016    ///
1017    /// # Upstream Documentation
1018    ///
1019    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_UserPinned`]
1020    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_UserPinned>
1021    UserPinned,
1022    /// Known Folder ID `FOLDERID_UserProfiles`.
1023    ///
1024    /// # Upstream Documentation
1025    ///
1026    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_UserProfiles`]
1027    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_UserProfiles>
1028    UserProfiles,
1029    /// Known Folder ID `FOLDERID_UserProgramFiles`.
1030    ///
1031    /// # Upstream Documentation
1032    ///
1033    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_UserProgramFiles`]
1034    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_UserProgramFiles>
1035    UserProgramFiles,
1036    /// Known Folder ID `FOLDERID_UserProgramFilesCommon`.
1037    ///
1038    /// # Upstream Documentation
1039    ///
1040    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_UserProgramFilesCommon`]
1041    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_UserProgramFilesCommon>
1042    UserProgramFilesCommon,
1043    /// Known Folder ID `FOLDERID_UsersFiles`.
1044    ///
1045    /// # Upstream Documentation
1046    ///
1047    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_UsersFiles`]
1048    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_UsersFiles>
1049    UsersFiles,
1050    /// Known Folder ID `FOLDERID_UsersLibraries`.
1051    ///
1052    /// # Upstream Documentation
1053    ///
1054    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_UsersLibraries`]
1055    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_UsersLibraries>
1056    UsersLibraries,
1057    /// Known Folder ID `FOLDERID_Videos`.
1058    ///
1059    /// # Upstream Documentation
1060    ///
1061    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Videos`]
1062    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Videos>
1063    Videos,
1064    /// Known Folder ID `FOLDERID_VideosLibrary`.
1065    ///
1066    /// # Upstream Documentation
1067    ///
1068    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_VideosLibrary`]
1069    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_VideosLibrary>
1070    VideosLibrary,
1071    /// Known Folder ID `FOLDERID_Windows`.
1072    ///
1073    /// # Upstream Documentation
1074    ///
1075    /// - [`windows_sys::Win32::UI::Shell::FOLDERID_Windows`]
1076    /// - <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid#FOLDERID_Windows>
1077    Windows,
1078}
1079
1080impl KnownFolder {
1081    #[must_use]
1082    pub(crate) const fn to_guid(self) -> &'static GUID {
1083        match self {
1084            Self::AccountPictures => &FOLDERID_AccountPictures,
1085            Self::AddNewPrograms => &FOLDERID_AddNewPrograms,
1086            Self::AdminTools => &FOLDERID_AdminTools,
1087            Self::AllAppMods => &FOLDERID_AllAppMods,
1088            Self::AppCaptures => &FOLDERID_AppCaptures,
1089            Self::AppDataDesktop => &FOLDERID_AppDataDesktop,
1090            Self::AppDataDocuments => &FOLDERID_AppDataDocuments,
1091            Self::AppDataFavorites => &FOLDERID_AppDataFavorites,
1092            Self::AppDataProgramData => &FOLDERID_AppDataProgramData,
1093            Self::AppUpdates => &FOLDERID_AppUpdates,
1094            Self::ApplicationShortcuts => &FOLDERID_ApplicationShortcuts,
1095            Self::AppsFolder => &FOLDERID_AppsFolder,
1096            Self::CDBurning => &FOLDERID_CDBurning,
1097            Self::CameraRoll => &FOLDERID_CameraRoll,
1098            Self::CameraRollLibrary => &FOLDERID_CameraRollLibrary,
1099            Self::ChangeRemovePrograms => &FOLDERID_ChangeRemovePrograms,
1100            Self::CommonAdminTools => &FOLDERID_CommonAdminTools,
1101            Self::CommonOEMLinks => &FOLDERID_CommonOEMLinks,
1102            Self::CommonPrograms => &FOLDERID_CommonPrograms,
1103            Self::CommonStartMenu => &FOLDERID_CommonStartMenu,
1104            Self::CommonStartMenuPlaces => &FOLDERID_CommonStartMenuPlaces,
1105            Self::CommonStartup => &FOLDERID_CommonStartup,
1106            Self::CommonTemplates => &FOLDERID_CommonTemplates,
1107            Self::ComputerFolder => &FOLDERID_ComputerFolder,
1108            Self::ConflictFolder => &FOLDERID_ConflictFolder,
1109            Self::ConnectionsFolder => &FOLDERID_ConnectionsFolder,
1110            Self::Contacts => &FOLDERID_Contacts,
1111            Self::ControlPanelFolder => &FOLDERID_ControlPanelFolder,
1112            Self::Cookies => &FOLDERID_Cookies,
1113            Self::CurrentAppMods => &FOLDERID_CurrentAppMods,
1114            Self::Desktop => &FOLDERID_Desktop,
1115            Self::DevelopmentFiles => &FOLDERID_DevelopmentFiles,
1116            Self::Device => &FOLDERID_Device,
1117            Self::DeviceMetadataStore => &FOLDERID_DeviceMetadataStore,
1118            Self::Documents => &FOLDERID_Documents,
1119            Self::DocumentsLibrary => &FOLDERID_DocumentsLibrary,
1120            Self::Downloads => &FOLDERID_Downloads,
1121            Self::Favorites => &FOLDERID_Favorites,
1122            Self::Fonts => &FOLDERID_Fonts,
1123            Self::GameTasks => &FOLDERID_GameTasks,
1124            Self::Games => &FOLDERID_Games,
1125            Self::History => &FOLDERID_History,
1126            Self::HomeGroup => &FOLDERID_HomeGroup,
1127            Self::HomeGroupCurrentUser => &FOLDERID_HomeGroupCurrentUser,
1128            Self::ImplicitAppShortcuts => &FOLDERID_ImplicitAppShortcuts,
1129            Self::InternetCache => &FOLDERID_InternetCache,
1130            Self::InternetFolder => &FOLDERID_InternetFolder,
1131            Self::Libraries => &FOLDERID_Libraries,
1132            Self::Links => &FOLDERID_Links,
1133            Self::LocalAppData => &FOLDERID_LocalAppData,
1134            Self::LocalAppDataLow => &FOLDERID_LocalAppDataLow,
1135            Self::LocalDocuments => &FOLDERID_LocalDocuments,
1136            Self::LocalDownloads => &FOLDERID_LocalDownloads,
1137            Self::LocalMusic => &FOLDERID_LocalMusic,
1138            Self::LocalPictures => &FOLDERID_LocalPictures,
1139            Self::LocalStorage => &FOLDERID_LocalStorage,
1140            Self::LocalVideos => &FOLDERID_LocalVideos,
1141            Self::LocalizedResourcesDir => &FOLDERID_LocalizedResourcesDir,
1142            Self::Music => &FOLDERID_Music,
1143            Self::MusicLibrary => &FOLDERID_MusicLibrary,
1144            Self::NetHood => &FOLDERID_NetHood,
1145            Self::NetworkFolder => &FOLDERID_NetworkFolder,
1146            Self::Objects3D => &FOLDERID_Objects3D,
1147            Self::OneDrive => &FOLDERID_OneDrive,
1148            Self::OriginalImages => &FOLDERID_OriginalImages,
1149            Self::PhotoAlbums => &FOLDERID_PhotoAlbums,
1150            Self::Pictures => &FOLDERID_Pictures,
1151            Self::PicturesLibrary => &FOLDERID_PicturesLibrary,
1152            Self::Playlists => &FOLDERID_Playlists,
1153            Self::PrintHood => &FOLDERID_PrintHood,
1154            Self::PrintersFolder => &FOLDERID_PrintersFolder,
1155            Self::Profile => &FOLDERID_Profile,
1156            Self::ProgramData => &FOLDERID_ProgramData,
1157            Self::ProgramFiles => &FOLDERID_ProgramFiles,
1158            Self::ProgramFilesCommon => &FOLDERID_ProgramFilesCommon,
1159            Self::ProgramFilesCommonX64 => &FOLDERID_ProgramFilesCommonX64,
1160            Self::ProgramFilesCommonX86 => &FOLDERID_ProgramFilesCommonX86,
1161            Self::ProgramFilesX64 => &FOLDERID_ProgramFilesX64,
1162            Self::ProgramFilesX86 => &FOLDERID_ProgramFilesX86,
1163            Self::Programs => &FOLDERID_Programs,
1164            Self::Public => &FOLDERID_Public,
1165            Self::PublicDesktop => &FOLDERID_PublicDesktop,
1166            Self::PublicDocuments => &FOLDERID_PublicDocuments,
1167            Self::PublicDownloads => &FOLDERID_PublicDownloads,
1168            Self::PublicGameTasks => &FOLDERID_PublicGameTasks,
1169            Self::PublicLibraries => &FOLDERID_PublicLibraries,
1170            Self::PublicMusic => &FOLDERID_PublicMusic,
1171            Self::PublicPictures => &FOLDERID_PublicPictures,
1172            Self::PublicRingtones => &FOLDERID_PublicRingtones,
1173            Self::PublicUserTiles => &FOLDERID_PublicUserTiles,
1174            Self::PublicVideos => &FOLDERID_PublicVideos,
1175            Self::QuickLaunch => &FOLDERID_QuickLaunch,
1176            Self::Recent => &FOLDERID_Recent,
1177            Self::RecordedCalls => &FOLDERID_RecordedCalls,
1178            Self::RecordedTVLibrary => &FOLDERID_RecordedTVLibrary,
1179            Self::RecycleBinFolder => &FOLDERID_RecycleBinFolder,
1180            Self::ResourceDir => &FOLDERID_ResourceDir,
1181            Self::RetailDemo => &FOLDERID_RetailDemo,
1182            Self::Ringtones => &FOLDERID_Ringtones,
1183            Self::RoamedTileImages => &FOLDERID_RoamedTileImages,
1184            Self::RoamingAppData => &FOLDERID_RoamingAppData,
1185            Self::RoamingTiles => &FOLDERID_RoamingTiles,
1186            Self::SEARCH_CSC => &FOLDERID_SEARCH_CSC,
1187            Self::SEARCH_MAPI => &FOLDERID_SEARCH_MAPI,
1188            Self::SampleMusic => &FOLDERID_SampleMusic,
1189            Self::SamplePictures => &FOLDERID_SamplePictures,
1190            Self::SamplePlaylists => &FOLDERID_SamplePlaylists,
1191            Self::SampleVideos => &FOLDERID_SampleVideos,
1192            Self::SavedGames => &FOLDERID_SavedGames,
1193            Self::SavedPictures => &FOLDERID_SavedPictures,
1194            Self::SavedPicturesLibrary => &FOLDERID_SavedPicturesLibrary,
1195            Self::SavedSearches => &FOLDERID_SavedSearches,
1196            Self::Screenshots => &FOLDERID_Screenshots,
1197            Self::SearchHistory => &FOLDERID_SearchHistory,
1198            Self::SearchHome => &FOLDERID_SearchHome,
1199            Self::SearchTemplates => &FOLDERID_SearchTemplates,
1200            Self::SendTo => &FOLDERID_SendTo,
1201            Self::SidebarDefaultParts => &FOLDERID_SidebarDefaultParts,
1202            Self::SidebarParts => &FOLDERID_SidebarParts,
1203            Self::SkyDrive => &FOLDERID_SkyDrive,
1204            Self::SkyDriveCameraRoll => &FOLDERID_SkyDriveCameraRoll,
1205            Self::SkyDriveDocuments => &FOLDERID_SkyDriveDocuments,
1206            Self::SkyDriveMusic => &FOLDERID_SkyDriveMusic,
1207            Self::SkyDrivePictures => &FOLDERID_SkyDrivePictures,
1208            Self::StartMenu => &FOLDERID_StartMenu,
1209            Self::StartMenuAllPrograms => &FOLDERID_StartMenuAllPrograms,
1210            Self::Startup => &FOLDERID_Startup,
1211            Self::SyncManagerFolder => &FOLDERID_SyncManagerFolder,
1212            Self::SyncResultsFolder => &FOLDERID_SyncResultsFolder,
1213            Self::SyncSetupFolder => &FOLDERID_SyncSetupFolder,
1214            Self::System => &FOLDERID_System,
1215            Self::SystemX86 => &FOLDERID_SystemX86,
1216            Self::Templates => &FOLDERID_Templates,
1217            Self::UserPinned => &FOLDERID_UserPinned,
1218            Self::UserProfiles => &FOLDERID_UserProfiles,
1219            Self::UserProgramFiles => &FOLDERID_UserProgramFiles,
1220            Self::UserProgramFilesCommon => &FOLDERID_UserProgramFilesCommon,
1221            Self::UsersFiles => &FOLDERID_UsersFiles,
1222            Self::UsersLibraries => &FOLDERID_UsersLibraries,
1223            Self::Videos => &FOLDERID_Videos,
1224            Self::VideosLibrary => &FOLDERID_VideosLibrary,
1225            Self::Windows => &FOLDERID_Windows,
1226        }
1227    }
1228}
known_folders\win/known_folder.rs

known_folders\win/
known_folder.rs
