GlobalizationPreferences.TrySetHomeGeographicRegion(String) Method

Reference

Definition

Namespace:: Windows.System.UserProfile

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

Attempts to set the user's home geographic region on an IoT device.

Note

This method is available only in Embedded mode.

public:
 static bool TrySetHomeGeographicRegion(Platform::String ^ region);

 static bool TrySetHomeGeographicRegion(winrt::hstring const& region);

public static bool TrySetHomeGeographicRegion(string region);

function trySetHomeGeographicRegion(region)

Public Shared Function TrySetHomeGeographicRegion (region As String) As Boolean

Parameters

region: String
Platform::String

winrt::hstring

The GeographicRegion identifier that represents the user's home location.

Returns

Boolean

bool

true if HomeGeographicRegion was set; otherwise, false.

Windows requirements

Device family	Windows 10 Fall Creators Update (introduced in 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v5.0)

Remarks

Your app must declare the systemManagement capability, which lets apps access basic system administration privileges including locale, timezone, shut down, and reboot.

The systemManagement capability must include the iot namespace when you declare it in your app's package manifest.

<Capabilities><iot:Capability Name="systemManagement"/></Capabilities>

Applies to