KnownFolders.MediaServerDevices | mediaServerDevices property

Gets the folder of media server (DLNA) devices.

Syntax


public:
static property StorageFolder^ MediaServerDevices { 
   StorageFolder^ get();
}

Property value

Type: StorageFolder

The folder of media server (DLNA) devices.

Remarks

Prerequisites

To access the media server devices folder, in the app manifest, specify at least one of the following capabilities: Pictures Library, Music Library, or Videos Library. Learn more about these capabilities in Access to user resources using the Windows Runtime.

Return value

The folder returned by the MediaServerDevices property is a virtual folder that contains an entry for each TBD.

To work with the media server devices folder and its contents, call the methods and properties of the StorageFolder class.

Note  

Windows Store apps only. If no media server devices are available, reading the value of this property returns an empty folder. It does not raise an exception.

Note  

If your app is a Windows Phone Store app, reading the value of this property raises an exception.

More info

In the media server devices folder, the app sees only the content that corresponds to the capabilities specified in the app's manifest. For example, an app that specifies only the Music Library capability sees only music content in the media server devices folder.

Note  

Your app can't see the contents of the Documents libraries of a media server devices folder regardless of the capabilities declared in the app's manifest and regardless of the user's sharing settings.

You can enumerate files and folders in the media server devices folder. When you create a CommonFileQuery or CommonFolderQuery query, however, you can only specify the DefaultQuery, OrderByName, or OrderBySearchRank options.

Some Digital Media Servers only support a single media restriction. These servers may incorrectly return 0 files for a query if you've specified two media library capabilities in the app manifest. If you've specified two media library capabilities - for example, Pictures Library and Videos Library - and a query returns 0 files, try changing the capabilities to specify either a single media library capability or all three media library capabilities. If you specify all 3 media library capabilities, no media restrictions are sent and this problem doesn't occur.

Requirements (device family)

Device family

Universal

API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0

Namespace

Windows.Storage
Windows::Storage [C++]

Metadata

Windows.Foundation.UniversalApiContract.winmd

Requirements (operating system)

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

None supported

Namespace

Windows.Storage
Windows::Storage [C++]

Metadata

Windows.winmd

See also

KnownFolders

 

 

Show:
© 2015 Microsoft