Avviare la pagina Impostazioni app predefinite

Informazioni su come avviare l'app di Impostazioni Windows per visualizzare la pagina delle impostazioni delle app predefinite dall'app usando lo schema URI ms-settings.

Windows definisce un set di URI che consentono alle app di avviare l'app Impostazioni Windows e visualizzare una determinata pagina delle impostazioni. Questo articolo illustra come avviare l'app di Impostazioni Windows direttamente nella pagina Impostazioni dell'app predefinite e, facoltativamente, passare direttamente alle impostazioni per un'applicazione predefinita specificata. Per maggiori informazioni, vedere Avviare l'app Impostazioni di Windows.

URL delle impostazioni delle app predefinite

ms-settings:defaultapps avvia l'app Impostazioni di Windows e passa alla pagina Impostazioni app predefinite. A partire da Windows 11, versione 21H2 (con aggiornamento cumulativo 2023-04), 22H2 (con aggiornamento cumulativo 2023-04) e 23H2 o versioni successive, è possibile aggiungere un parametro aggiuntivo della stringa di query in formato URI con escape per avviare direttamente la pagina delle impostazioni per un'applicazione specifica.

Esistono tre parametri della stringa di query. Il parametro della stringa di query da usare dipende dalla modalità di installazione dell'applicazione.

Parametro della stringa di query Valore da passare
registeredAppUser Valore denominato da HKEY_CURRENT_USER\Software\RegisteredApplications

Usare quando l'app è stata installata per l'utente e la registrazione per l'app è stata scritta in HKEY_CURRENT_USER\Software\RegisteredApplications.
registeredAppMachine Valore denominato da HKEY_LOCAL_MACHINE\Software\RegisteredApplications

Usare quando l'app è stata installata per ogni computer e la registrazione per l'app è stata scritta in HKEY_LOCAL_MACHINE\Software\RegisteredApplications.
registeredAUMID ID modello utente applicazione

Usare quando l'app è stata registrata con Gestione pacchetti usando un manifesto che dichiara che l'app gestisce tipi di file (uap:FileTypeAssociation) o schemi URI (uap:Protocol).

Nota

Per ottenere il parametro della stringa di query registeredAUMID affinché funzioni dopo un aggiornamento del sistema operativo, un'app potrebbe dover incrementare targetDeviceFamily... Valore MaxVersionTested nel relativo manifesto. In questo modo l'app viene reindicizzata per l'utente, che a sua volta aggiornerà le definizioni appropriate usate per elaborare il collegamento diretto tramite l'attivazione del protocollo. MaxVersionTested deve essere aggiornato a 10.0.22000.1817 per Windows 11 versione 21H2 o 10.0.22621.1555 per Windows 11 versione 22H2.

Nell'esempio LaunchUriAsync seguente viene chiamato per avviare l'app Impostazioni windows. L'URI ms-settings:defaultapps specifica che deve essere visualizzata la pagina Impostazioni app predefinite. Successivamente, viene determinata l'app che deve essere avviata. Ad esempio, "Microsoft Edge" è stato registrato dall'app in HKEY_LOCAL_MACHINE\Software\RegisteredApplications. Poiché si tratta di un'app installata per computer, registeredAppMachine è il parametro della stringa di query che deve essere usato. Il parametro registeredAppMachine facoltativo della stringa di query è impostato sul nome registrato, preceduto da una chiamata a Url.EscapeDataStringper specificare che deve essere visualizzata la pagina per Microsoft Edge.

private async void LaunchSettingsPage_Click(object sender, RoutedEventArgs e)
{
    bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-settings:defaultapps?registeredAppMachine=" + Uri.EscapeDataString(("Microsoft Edge")));
}
bool result = co_await Windows::System::Launcher::LaunchUriAsync(Windows::Foundation::Uri(L"ms-settings:defaultapps?registeredAppMachine=" + Uri::EscapeDataString(L"Microsoft Edge")));

Vedi anche

Avviare l'app Impostazioni di Windows

Avviare l'app predefinita per un URI