storagefolder_createfolderquerywithoptions_573382953.md

-api-id	-api-type
M:Windows.Storage.StorageFolder.CreateFolderQueryWithOptions(Windows.Storage.Search.QueryOptions)	winrt method

Windows.Storage.StorageFolder.CreateFolderQueryWithOptions

-description

Gets a query result object that contains the subfolders in the current folder and, optionally, nested subfolders. The results are based on the specified QueryOptions.

-parameters

-param queryOptions

The criteria that are applied to the query.

-returns

A query result object. Call the GetFoldersAsync method of the query result to get the subfolders in the current folder. If you provided a CommonFolderQuery value other than CommonFolderQuery.DefaultQuery when you instantiated the QueryOptions, the query result object contains a list of virtual folders that represent containers for groups of files in the subfolders of the current folder. (Files from the current folder are not included.) The files are grouped as specified by queryOptions. The list is of type IReadOnlyList<StorageFolder>. Each folder in the list is represented by a StorageFolder object.

-exceptions

T:System.UnauthorizedAccessException

You don't have permission to access the contents of the current folder.

-remarks

For more information and examples on getting query result objects, see CreateFileQueryWithOptions.

-examples

-see-also