Merge pull request #4077 from MicrosoftDocs/alvinashcraft-main-file-folder-pickers-add-callout-win32

Add note about elevated desktop apps to File and Folder pickers

Author: alvinashcraft

hub/apps/develop/files/index.md

@@ -41,7 +41,7 @@ If you're developing packaged WinUI apps, the WinRT storage APIs can be a powerf
 | [Create, write, and read a file](/windows/uwp/files/quickstart-reading-and-writing-files) | Read and write a file using a [StorageFile](/uwp/api/Windows.Storage.StorageFile) object. |
 | [Best practices for writing to files](/windows/uwp/files/best-practices-for-writing-to-files) | Learn best practices for using various file writing methods of the [FileIO](/uwp/api/windows.storage.fileio) and [PathIO](/uwp/api/windows.storage.pathio) classes. |
 | [Get file properties](/windows/uwp/files/quickstart-getting-file-properties) | Get properties—top-level, basic, and extended—for a file represented by a   [StorageFile](/uwp/api/Windows.Storage.StorageFile) object. |
-| [Open files and folders with a picker](/windows/uwp/files/quickstart-using-file-and-folder-pickers) | Access files and folders by letting the user interact with a picker. You can use the   [FolderPicker](/uwp/api/Windows.Storage.Pickers.FolderPicker) to gain access to a folder. |
+| [Open files and folders with a picker](/windows/uwp/files/quickstart-using-file-and-folder-pickers) | Access files and folders by letting the user interact with a picker. You can use the   [FolderPicker](/uwp/api/Windows.Storage.Pickers.FolderPicker) to gain access to a folder.<br/><br/>**NOTE:** In a desktop app (which includes WinUI 3 apps), you can use file and folder pickers from [Windows.Storage.Pickers](/uwp/api/windows.storage.pickers). However, if the desktop app requires elevation to run, you'll need a different approach because these APIs aren't designed to be used in an elevated app. For an example, see [FileSavePicker](/uwp/api/windows.storage.pickers.filesavepicker#in-a-desktop-app-that-requires-elevation). |
 | [Save a file with a picker](/windows/uwp/files/quickstart-save-a-file-with-a-picker) | Use [FileSavePicker](/uwp/api/Windows.Storage.Pickers.FileSavePicker) to let users specify the name and location where they want your app to save a file. |
 | [Accessing HomeGroup content](/windows/uwp/files/quickstart-accessing-homegroup-content) | Access content stored in the user's HomeGroup folder, including pictures, music, and videos. |
 | [Determining availability of Microsoft OneDrive files](/windows/uwp/files/quickstart-determining-availability-of-microsoft-onedrive-files) | Determine if a Microsoft OneDrive file is available using the [StorageFile.IsAvailable](/uwp/api/windows.storage.storagefile.isavailable) property. |

uwp/files/quickstart-save-a-file-with-a-picker.md

@@ -2,7 +2,7 @@
 ms.assetid: 8BDDE64A-77D2-4F9D-A1A0-E4C634BCD890
 title: Save a file with a picker
 description: Use FileSavePicker to let users specify the name and location where they want your app to save a file.
-ms.date: 12/19/2018
+ms.date: 02/08/2024
 ms.topic: article
 keywords: windows 10, uwp
 ms.localizationpriority: medium
@@ -11,32 +11,32 @@ ms.localizationpriority: medium
 
 **Important APIs**
 
--   [**FileSavePicker**](/uwp/api/Windows.Storage.Pickers.FileSavePicker)
--   [**StorageFile**](/uwp/api/Windows.Storage.StorageFile)
+- [**FileSavePicker**](/uwp/api/Windows.Storage.Pickers.FileSavePicker)
+- [**StorageFile**](/uwp/api/Windows.Storage.StorageFile)
 
 Use [**FileSavePicker**](/uwp/api/Windows.Storage.Pickers.FileSavePicker) to let users specify the name and location where they want your app to save a file.
 
 > [!NOTE]
 > For a complete sample, see the [File picker sample](https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/FilePicker).
 
- 
+> [!NOTE]
+> In a desktop app (which includes WinUI 3 apps), you can use file and folder pickers from [Windows.Storage.Pickers](/uwp/api/windows.storage.pickers). However, if the desktop app requires elevation to run, you'll need a different approach because these APIs aren't designed to be used in an elevated app. For an example, see [FileSavePicker](/uwp/api/windows.storage.pickers.filesavepicker#in-a-desktop-app-that-requires-elevation).
 
 ## Prerequisites
 
-
--   **Understand async programming for Universal Windows Platform (UWP) apps**
+- **Understand async programming for Universal Windows Platform (UWP) apps**
 
     You can learn how to write asynchronous apps in C# or Visual Basic, see [Call asynchronous APIs in C# or Visual Basic](../threading-async/call-asynchronous-apis-in-csharp-or-visual-basic.md). To learn how to write asynchronous apps in C++, see [Asynchronous programming in C++](../threading-async/asynchronous-programming-in-cpp-universal-windows-platform-apps.md).
 
--   **Access permissions to the location**
+- **Access permissions to the location**
 
     See [File access permissions](file-access-permissions.md).
 
 ## FileSavePicker: step-by-step
 
 Use a [**FileSavePicker**](/uwp/api/Windows.Storage.Pickers.FileSavePicker) so that your users can specify the name, type, and location of a file to save. Create, customize, and show a file picker object, and then save data via the returned [**StorageFile**](/uwp/api/Windows.Storage.StorageFile) object that represents the file picked.
 
-1.  **Create and customize the FileSavePicker**
+1. **Create and customize the FileSavePicker**
 
     ```cs
     var savePicker = new Windows.Storage.Pickers.FileSavePicker();
@@ -48,21 +48,21 @@ Use a [**FileSavePicker**](/uwp/api/Windows.Storage.Pickers.FileSavePicker) so t
     savePicker.SuggestedFileName = "New Document";
     ```
 
-Set properties on the file picker object that are relevant to your users and your app. This example sets three properties: [**SuggestedStartLocation**](/uwp/api/windows.storage.pickers.filesavepicker.suggestedstartlocation), [**FileTypeChoices**](/uwp/api/windows.storage.pickers.filesavepicker.filetypechoices) and [**SuggestedFileName**](/uwp/api/windows.storage.pickers.filesavepicker.suggestedfilename).
-     
-- Because our user is saving a document or text file, the sample sets [**SuggestedStartLocation**](/uwp/api/windows.storage.pickers.filesavepicker.suggestedstartlocation) to the app's local folder by using [**LocalFolder**](/uwp/api/windows.storage.applicationdata.localfolder). Set [**SuggestedStartLocation**](/uwp/api/windows.storage.pickers.fileopenpicker.suggestedstartlocation) to a location appropriate for the type of file being saved, for example Music, Pictures, Videos, or Documents. From the start location, the user can navigate to other locations.
+    Set properties on the file picker object that are relevant to your users and your app. This example sets three properties: [**SuggestedStartLocation**](/uwp/api/windows.storage.pickers.filesavepicker.suggestedstartlocation), [**FileTypeChoices**](/uwp/api/windows.storage.pickers.filesavepicker.filetypechoices) and [**SuggestedFileName**](/uwp/api/windows.storage.pickers.filesavepicker.suggestedfilename).
+
+    - Because our user is saving a document or text file, the sample sets [**SuggestedStartLocation**](/uwp/api/windows.storage.pickers.filesavepicker.suggestedstartlocation) to the app's local folder by using [**LocalFolder**](/uwp/api/windows.storage.applicationdata.localfolder). Set [**SuggestedStartLocation**](/uwp/api/windows.storage.pickers.fileopenpicker.suggestedstartlocation) to a location appropriate for the type of file being saved, for example Music, Pictures, Videos, or Documents. From the start location, the user can navigate to other locations.
 
-- Because we want to make sure our app can open the file after it is saved, we use [**FileTypeChoices**](/uwp/api/windows.storage.pickers.filesavepicker.filetypechoices) to specify file types that the sample supports (Microsoft Word documents and text files). Make sure all the file types that you specify are supported by your app. Users will be able to save their file as any of the file types you specify. They can also change the file type by selecting another of the file types that you specified. The first file type choice in the list will be selected by default: to control that, set the [**DefaultFileExtension**](/uwp/api/windows.storage.pickers.filesavepicker.defaultfileextension) property.
+    - Because we want to make sure our app can open the file after it is saved, we use [**FileTypeChoices**](/uwp/api/windows.storage.pickers.filesavepicker.filetypechoices) to specify file types that the sample supports (Microsoft Word documents and text files). Make sure all the file types that you specify are supported by your app. Users will be able to save their file as any of the file types you specify. They can also change the file type by selecting another of the file types that you specified. The first file type choice in the list will be selected by default: to control that, set the [**DefaultFileExtension**](/uwp/api/windows.storage.pickers.filesavepicker.defaultfileextension) property.
 
     > [!NOTE]
     > The file picker also uses the currently selected file type to filter which files it displays, so that only file types that match the selected files types are displayed to the user.
 
-- To save the user some typing, the example sets a [**SuggestedFileName**](/uwp/api/windows.storage.pickers.filesavepicker.suggestedfilename). Make your suggested file name relevant to the file being saved. For example, like Word, you can suggest the existing file name if there is one, or the first line of a document if the user is saving a file that does not yet have a name.
+    - To save the user some typing, the example sets a [**SuggestedFileName**](/uwp/api/windows.storage.pickers.filesavepicker.suggestedfilename). Make your suggested file name relevant to the file being saved. For example, like Word, you can suggest the existing file name if there is one, or the first line of a document if the user is saving a file that does not yet have a name.
 
-> [!NOTE]
-> [**FileSavePicker**](/uwp/api/Windows.Storage.Pickers.FileSavePicker) objects display the file picker using the [**PickerViewMode.List**](/uwp/api/Windows.Storage.Pickers.PickerViewMode) view mode.
+    > [!NOTE]
+    > [**FileSavePicker**](/uwp/api/Windows.Storage.Pickers.FileSavePicker) objects display the file picker using the [**PickerViewMode.List**](/uwp/api/Windows.Storage.Pickers.PickerViewMode) view mode.
 
-2.  **Show the FileSavePicker and save to the picked file**
+2. **Show the FileSavePicker and save to the picked file**
 
     Display the file picker by calling [**PickSaveFileAsync**](/uwp/api/windows.storage.pickers.filesavepicker.picksavefileasync). After the user specifies the name, file type, and location, and confirms to save the file, **PickSaveFileAsync** returns a [**StorageFile**](/uwp/api/Windows.Storage.StorageFile) object that represents the saved file. You can capture and process this file now that you have read and write access to it.
 
@@ -99,3 +99,13 @@ The example checks that the file is valid and writes its own file name into it.
 
 > [!TIP]
 > You should always check the saved file to make sure it is valid before you perform any other processing. Then, you can save content to the file as appropriate for your app, and provide appropriate behavior if the picked file is not valid.
+
+## See also
+
+[Windows.Storage.Pickers](/uwp/api/windows.storage.pickers)
+
+[Files, folders, and libraries](index.md)
+
+[Integrating with file picker contracts](/previous-versions/windows/apps/hh465192(v=win.10))
+
+[Creating, writing, and reading a file](quickstart-reading-and-writing-files.md)