KnownFolders.GetFolderAsync(KnownFolderId) Method

Reference

Definition

Namespace:: Windows.Storage

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

Retrieves the folder for the folderId specified.

public:
 static IAsyncOperation<StorageFolder ^> ^ GetFolderAsync(KnownFolderId folderId);

/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<StorageFolder> GetFolderAsync(KnownFolderId const& folderId);

[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFolder> GetFolderAsync(KnownFolderId folderId);

function getFolderAsync(folderId)

Public Shared Function GetFolderAsync (folderId As KnownFolderId) As IAsyncOperation(Of StorageFolder)

Parameters

folderId: KnownFolderId

The Id of the folder to be returned.

Returns

IAsyncOperation<StorageFolder>

When this method completes, it returns the requested StorageFolder object.

Attributes: RemoteAsyncAttribute

Windows requirements

Device family	Windows 10, version 2004 (introduced in 10.0.19041.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v10.0)

Remarks

This is a Single User Aware (SUA) method.

If the app does not have access because it isn’t manifested with the required capability, the user denied access from a prompt or the settings page, or a system administrator has disabled access, then this call will fail with access denied.

Applies to